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6 E M D 0 8 i s a s i n g 1 e u s 0 r o p e r a t i n g s y s 1 0 rn d e s i g n 0 d f o r t h 0 i v i 0 1 o r o 1 a« „ 

TM 

MC 68000 or cornpati bl 0 68000 mi croprocessor« GEM DOS requi res the 

f o 3.1 o w i n g m i n i m u m s y s 1 0 m c o n f i g u. r a t i o n s 

* 68000 rn i c: r o p r q c: 0 s s o r 

B i t.rn a p p 0 d v i d 0 o c o n t r 0 1 I 0 r c a r d a n d a d i s p i a y w i t h 320 h y 2 0 0 

resolution 

* 12 8 K b y 1 0 s o f R a n d o rn A c c: 0 s s M 0 rn o r y (E A M > 

* 16 0 K b y 1 0 s 0 f F< 0 a d ~ 0 n 1 y M 0 m 0 r y ( R 0 M > 

* A n 0 p t i c: a 1 0 r t r a c k rn o u s 0 0 r 0 1 h 0 r p 0 1 n t i n g d 0 v i c 0 

T h0 f o 11 0wi ng con f :i. gurat i 0n r0pr0s0nts a sys 1 0rn that ean 0x0rcis0 tFt0 f u 11 

c: a p a b i 1 i t i 0 s 0 f 0 E M D 0 8 s 

* 68010 h 68020 , 0 r 68 07 0 a d v a n c 0 d m i c: r 0 p r 0 c 0 s s 0 r 

* H i q h.r 0 s o 1 li t i o n H c: 0 1 □ r h i t -• m a p p 0 d d i s p 1 a y a n d e 0 n t r 0 3.1 0 r ( 640 b y 4 0 0 

p i x 0 1 r 0 s 0 1 la 11 o n tJ h a r r 0 1 - s h i f 1 0 r h a r d w a r 0 f0 r v 0 r y h i q h s p 0 0 d s c r 0 0 n 

refresh) 

* 256 K bytes of RAM 

* 192 K bytes of ROM 

* Mouse 

* D i s k d r i v 0 s a n d c 0 n t r □ 11 0 r s 

* 0 p t 1 c a 1 d r i v 0 is a n d c 0 n t r 0 11 e r s 

* P r i n 1 0 r a n d c 0 rn rn u n i c a t i 0 n p 0 r t s 

T h i s g t.i i c:i 0 d e s c r i b 0 s t h 0 p r 0 g r a rri m i n g i n 1 0 r f a c:: 0 1 0 G E M D 0 S a n d i ss p a r t 0 f a 

d 0 c la m 0 n t a t :i 0 n s 0t t h a t a 1 s o 1 n c 1 u d 0 s t h 0 s 0 m a n u a 1 s s 

T Ft e? G E M D 0 S U s 0 r ' s G la i d 0 

* T h 0 C L a n g u. a g 0 P r o g r a rn rn i n g G u i d 0 f o r G E M D 0 S ( s u p p 1 0 rn 0 n t 1 0 t h 0 C 

L a n g la a g 0 P r 0 g r a m m i n g 8 la i d 0 f o r C P / M - 6 8 K » .. ) 

* I h 0 M i n c 0 U s e r ' s G u i d e , p r 0 p a r 0 d fo y M a r k 0 f t h e U n i c: 0 r n , I n c * 

* T Ft 0 K 0 r m i t U s 0 r * s 6 la i c:l 0 p r e p a r 0 d h y C a 1 la m b i. a U n i v 0 r s i t y C 0 n 1 0 r f 0 r 
C 0 m p u. t i n q A c t i v i t i 0 s 

* T h 0 G E! M D 0 S S u p? p 1 0 m 0 n t t o t h 0 K 0 r m i t U s 0 r s (3 u i d 0 

T Ft 1 is g la i d 0 a s is u m 0 is y 0 la a r 0 a n 0 x p e r i e n c e d p r 0 g r a m m e r f a m i 1 i a r w i t h t h 0 
M 0 1 0 r 0 1 a 68000 a s is 0 rn b 1 y 1 a n g u a g 0 a n d t h C p r 0 q r a m rn :i. n g i a n g u a g 0.. 1 f y o la 

a r 0 n o t; f a m i 1 :i. a r w i t ri G E l ¥ l D 0 8 , r e f 0 r t o t h 0 rn a n la a 1 is X i s 1 0 d a b o v 0 , 

especially the GEM DOB User's Guide. If you are not familiar with the 
l v i o 1 0 r 0 1 a 68000 a s s 0 m h 1 y 1 a n g u a g 0 , r 0 f 0 r t c:« t h 0 f 0 3.1 0 w i n q M o 1 0 r o 1 a m a n u a 1 is s 

* 16 ••••• B i t M i c: r o p r o c e s s 0 r IJ s 0 r ‘ s M a n u a 1 :« t h i r d e d i t i 0 n i v l C6 300 0U M (A D 3) 

* M C68000 R 0 is i ci 0 n t S t r u c: t u r 0 d A s s e m b 1 0 r R e f 0 r e n c 0 li a n la a 1 M 6 8 K li A 8 M (D 4) 
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The f oI 1 owinq i s a summary of the contents of thi s gui cle s 

* Sect i on 1 di scusses the GEIi DOS system archi Lecture, f i 1 e 

s p e c i f i c a t i o n h a n d t e r m i n o i o g y. 

■x* S e c t i o n 2 d e s c r i b e © t h e p r o g r a rn rn i n g 1 o a d i n q p r o c e d u r e .. t r a n s i e n t 

prc"»gram envi ronment, and how to ex :L t a transi ent program« 

•x* Section 3 describes the GEIi DOS comand file (transient program) format* 

* Sec t i on 4 1 i st s t h e sy st em f unc t i on c: a 11 c at eg ories an d d e©c r i b es t h e 

system functions and their entry parameters and return codes,, 

* S e c t i o n 5 d e s c: r i b e s t h e G E li D 0 S a s s e m b 1 e r . 

* S e c t i o n 6 d e s c r i h e s t h e G E M D 0 S 1 i n k e r s. 

•x* Sect i on 7 descr i bes the OEM DOS arch i ve uti 1 i ty» 

* Section 8 describes the DUMP, 81 ZE68, and SENDC68 utiIities« 

TM 

* S e c t i o n 9 d e s c r i b e s t hi e SID - 6 8 K d e b u g g e r „ 

* A p p e n d i x A 1 i s t s t h e B10 S f u n c t i o n s« 

•x* Appendix B shows the format of the GEN DOS base page* 

* A p p e ri d i x C c o n t a i n s a d e e i rn a 1 - A S C11 - h e x a d e c i rn a 1 c o n v e r s i o n t a b 1 « 

* A p p e n d i x D 1 i s t s t h e e r r o r m e s s a g e s r e t u r n e d b y t h e G E M D 0 S p r o g r a m m i n g 

uti1ities« 

■x* A p p & n «::l i x Ei d e s c r i b e s t h e M o t o r o 1 a S - E e c o r d f o r rn a t« 
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INTRODUCTION TO GEN DOS 

1.1 SYSTEM ARCHITECTURE 

Tab 1 e 1 ■•••• i des c r i b es t h e t h ree mo d u I es t h at c ompr i se 6EM D0S „ 


Tab 1 e 1 ~ 1. GEN DOS System Modul es 

Module 

Con so I e Coalman d Pr oc essor 
(CCP) 

Basic Disk Operating System 
< BDOS > 

B a s i c I / 0 S y s t e m 
(B IOS ) 


1.2 TRANSIENT PROGRAMS 

T I") e T r a n s i e n t P r o q r a rn A r e a < T P A) c: o n s :i. s t s o f a 11 t h e c o n t i q u o u s m e m o r y 

space not occupied by the operating system when GEN DOS is resident in 

m e rn o r y.« 6 E N D 0 5 1 o a d s e k e c u t a b 1 e c o m m a n d f i 1 e s f r o m d i s k i n t o t h e T P A „ 

C o m m a n d til e s a r e a 1so c a 11 e d t r a n s i e n t p r o g r a rn s b e c: a u s e t h e y a r e n o t 

rn e rn o r y res i d e n t n o r c o n f i g u r e d w i t h i n t h e o p e r a t i n g s y s t e m« S e c: t i o n 3 

d e sc rib es t h e tor mat of a GEN D0S comman c 1 fi1e. 

S e c t i o n 2 M 11 T h e C C P a n d T r ansi e n t P rg r a m s, 11 d e s c. r i b e s h o w 

Section 2, “The CCP and Transient Programs, 11 describes how GEM DOS formats 

t h e T P A f o r p r o g r a m s :i. t I o a d s i n t o rn e rn o r y f o r e k e c u t i o n, 
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1.3 PROGRAMMINB TOOLS 

T a b i e 1 2 I i s t s t h e a 0 s 0 m b 1 y 1 a n q u a g 0 p r o q r a m m i n g t o o 1 s p r o v i d 0 d w i t h 8 E M 
D08M Th 0150 too 1 s ar 0 d 00 cr i b 0 d i n Secti ons 5 through 9 of thi s gui d 0 « 


T a h I 0 1 "••• 2« 6 E M D 0 B P r a q r a. m m i n g T o o I s 

P r o g r a m P u r p o s 0 

A R 6 8 C r 0 a 1 0 s a n d m o d i f i 0 s o b j 0 c t m 0 d u i 0 1 i b r a r i 0 s 

AS68 Processes assembly language source modules to create 

r 0 J. o c a t a b 1 0 o b j 0 c t m o d u 1 0 1 i b r a r y f i 1 0 s 

D U M P D i s p 1 a y s f i 1 0 s i n h 0 x a d 0 c i m a 1 and A S C11 n o t a t i o n 

TM 

LINK68 A 1 i n k 0 r th at c omb i n 0 s ass 0 mb 1 0 d or c omp i 1 0 d ob j ec t rnod u 1 0 s 

w i t h o t h e r m o d u 1 0 s t r o rn a r u n t i m 0 1 i b r a r y 

L.068 Another 1 i nker 

N M 6 £1 P r i n t s t h 0 s y rn b o 1 t a b 1 e o f a n o b j 0 c t or- c o rn rn a n d f i 1 0 

EELOG Converts relocatable object modules from one format to 

another 

SENDC68 Con ver t s a c ornman d f i 1 0 t o t h 0 Mot or o 1 a S-r ec or d f or mat 

TM 

81D 6 8 K T e s t s a n d d 0 b u g ns p r o g r a rn s 

SIZE68 Displays the size of each program segment within one or 
rn o r 0 c o m rn a n d f lies 

X R E F C r 0 a 1 0 s a t a h 1 0 o f t h & s y rn b o i. s d 0 f i n 0 ci a n d r e f 0 r e n c e d b y 

object f i 1 015 


Use AS68 t o assemb 1 0 t h & f i 1 0 and 0 i t hL1NK68 or LG88 t o 1 i n k i t. AR68 
creates library modules that can be linked with LINK68 or L068. Both of 
t h 0 l i n k 0 r s u. se a n d c r 0 a t e t h 0 a m e f i .1 0 f or mats „ hi o w 0 v 0 r , i f y o u a r 0 n o t 
linking with runtime modules, L068 provides better performance. 

Nrj68 is d 0 scrib 0 d in S 0 ction 3« 

GEM DOS also supports a C language compiler for the 68000 microprocessor. 
8 0 0 t h 0 C L... a n q u a g 0 P r o g r a m m .i n g 8 u i d 0 for 8 E M D 0 8. 
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1 - 4 GEM DOS FILE SPECIFICATION 

The GEM DOS file specification consists of four fields 3 a one-character 
drive designation delimited by a colon (ds), a directory path in which 
directory names are delimited by backslashes <\), a one- to eight-character 
filename, and an optional one- to three-character filetype separated from 
t hi e f i 1 e n a m e h y a p e r i o d <« ) ,. D i r e c t o r i e s a n d f i 1 e s h a v e t h e s a m e n a rn i n g 
conventions- The format of a file specification is shown below- 
Format s 

d r, \ p at h \ f :L 1 en a me.t y p 
Examp1e: 

An\LIBRARV\OBJ S\FLOATER.OBJ 

T h e d r i v e d e s i g n a t i o n , p a t h, a n d f i 1 e t y p e f i e 1 d s a r e o p t i o n a 1 « T h e c o 1 o n , 
b a c k s 1 a s h , a n d p e r i o d d e 1 i m i t e r s a r e r e q u i r e d o n 1 y w h e n y o u i n elude 11") e s e 
f i e? 1 d s i n t h e f i 1 e s p e c i f i c a t i o n ,, 

Dr i ve d esi gn a t i on va lues r ang e f r om A t h r ouqh F 4 when t he B10B 
imp1ementation supports 16 drives* the maximum number that GEM DOS can 
support- See Section 4.5, “File Management Functions-“ 

T h e c I "! a r a c t e r s i n t h e f i 1 e n a m e a n d f i 1 e t y p e f i e? 1 d s c a n ri o t c o n t a i n 
c:le 1 i rni ter s (the co 1 on , backs 1 ash , and per i od ) „ The CCF 4 automat i ca 11 y 

converts a command 1ine and its fi1e specifications <if any) to uppercase 
interna11y before parsing them- 

T a b 1 e? 1 - 3 1 i s t s s o m e a d d i t i o n a 1 c h a r a c t e r s y o u s hi o u 1 d a v o i d u s i n g i n y o u r 
file specifications. These characters are reserved because several OEM DOS 
built-in commands and utilities have special uses for them. 


Table 1-3. 


De1imit er Charact er s 


Character 


i :\ 

() 


* 

& 

? 

1 

1 

i 

/ 

\ 

T 
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1.5 WILDCARDS 


GEM DOS supports two wildcards, the question mark <?) and thee asterisk (#) > 
Several utilities and BDOS functions allow you to specify wildcards in a 
file specification to perform the? operation or function on one or more 
fi1es. 


The ? wi1dcard matehes any one character in the character position occupied 
by th i s wi 1 dc.Brd „ For ex amp 1 e , the file spec i f i cat i on WH7TMAN« OBJ 

indicates that the third letter of the filename can be any alphanumeric 
character if the remainder of the file spedfication matches. Thus, the ? 
w i 1 d c a r d m a t c h e s e x a c 1 1 y o n e c h a r a c t e r p o s i t i o n„ 


The * wildcard matches one or more characters in the field or remainder of 
a fie 1 d that t h i s wi 1 dcar d occup i es „ OEM DOS i nt E?r na 11 y pads the f i e 1 d or 
r emaining portion of t he fie1d ac c upied b y t h e * wi1d c ard with ? wi1d car d s 
before searching for a match. For example, GEM DOS converts the file 
specification 8*« 3 A7 to G???????«BAT before searching f or a matching fi1e 
s p e c i f i a t i o n „ T h u s , a n y f i 1 e t h a t s t a r t s with t h e 1 e 11 e r G a n d h a s a 
fi1etype of BAT matches this fi1e specification. 


For details on wildcard support by specific BDOS functions, refer to the 
description of the function in Section 4 of this guide. For additional 
detai1s on these wiIdcards and support b y GEM D0S uti1ities, refer to the 
8EM D08 User s 8ui de and Sec t i ons 5 t hr c:>ugh 9 a f th i s guide. 
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.1.. 6 BEM DOS TERMINOLOGY 

Table l-4 list the terminology used throughout this guide to describe BEM 
DOS values and program components. 


Tab1e 1-4« B E M D0S Termin olog y 

Term Meaning 

N i b b I e 4 - b i t v a 1 u e 

B y t e 8 b i t val u e 

Wor d 16 •*bi t val tie 

Longward Signed 32-foit value 

Address 32-bit value that specifies a storage 1ocation 

Of f set A f i x ed d i sp 1 acement that r ef erences a stor age 1 ocat i on 
o t h e r d a t a s o u r c e , o r d e s t i n a t i o n 

Text Segment 

T h e s e c t i o n o f a p r o g r a m t h a t c o n t ax i n s t h e p r o g r a rn 

instructions 

D a t a S e g m e n t 

The section of a program that contains initialized data 

bss The b 1 ock storage segment is a section of a program that 

contains uninitiaiized data 
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T ab 1 e 1 -5 d esc: r i b es c on van t i on s used i n this g u i d e« 


T a b 1 e i 5» B E M D 0 S P r o q r a m m e r s 8 u i d e C o n v e n t i o n s 
Convent1 on 

Meaning 

1 3 Square brae: kets i n a command 1 i ne enc 1 ose opt i onal 

parameters. 

nH The capital letter H follows numeric: values that are 

represented in hexadecimal notation« 

< n ) & D 0 8 f u n c t i o n n u rn b e r s a re e n c: 1 o seel 1 n p a r e n t h e s e s w h e n t h e y 

a p p e a r i n t e m t« 

Ctrl The mnemonic Ctrl ~~X indicates that you are to hold down the 

key 1abe1ed Ctr1 wh11e you press the key represented by the 
vari abl & X . 

End of Section 1 
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THE CCP AND TRANSIENT PROGRAMS 


1" h i s s e c t i o n cl i s c la s s e s t h e C a n s o 1 0 C o m m a n d P r o c 0 s s o r < C C P ) , b u i 1 1 - :i n a n d 
t r a n nsi 0 nt c omm a nd ns , 1 o adi n g and e x .i t i n g tr a n si ent p ro grams , a nd the GEM D0S 
p r o g r a m 0 x 0 c u t i o n m o d 0 1 . 


2.1 CCP BUILT-IN AND EXTERNAL COMMANDS 

After an initial cold start, GEM DOS displays a sign-on message at the 
console. The drive containing the system disk is logged in automatically. 
GEM DOS displays its ”la> u prompt to indicate the currently logged in 
drive, and that the operating system is ready to receive a command line 
f r o m t h 0 c o n s o I 0 . 

I n r 0 s p o n s e t o t h 0 p r o m p t, a u s 0 r t y p 0 s t h 0 f i 1 0 n a m 0 o f a bat c h o r c o rn m a n d 
file with its command tail, if required. GEM DOS supports two types of 
c o rn m a n d s , b u i 11 - i n a n d t r a n s i 0 n t. B u i 11 - i n c: o m m a n d s a re pa r t o f t hi 0 C C P « 
Transient commands are loaded in the TPA and do not reside in memory 
a 11 oca1 0 d to GEM D0S» The 8 E M D0E> Us 0 r 's Gui d 0 describes th 0 bui 11-i n and 
transient commands that GEM DOS supports. 

A t r a n s i e n t c o m rn a n d i s a rn a c h i n 0 - r 0 a cl a b 1 0 p r o g r a m f i 1 0 t h a t G E M D 0 S 1 o a d s 
f r om d .i sk i n t o memor y f or ex ecut i on . Sect i on 3 describes the f or mat of 
transient command fi1es. 

W h 0 n t h 0 u s e r 0 n t e r s a c o m m a n d 1 i n 0 , t h 0 C C P p a r s 0 s i t a n d t r i 0 s t o e x 0 c: u 1 0 
t h e f i 1 e s pecified« T h e C C P a s s s u m 0 s a file is a c o m m a n d file w h e n i t h a s 
t h 0 f i 1 e t y p 0 B A T« W h 0 n t h 0 u s 0 r s p 0 c i f i 0 s o n 1 y t h 0 f i 1 0 n a m 0 , t h e C C P 

searches the current directory and drive for a file with a matching 
f i 1 0 n a rn 0 a n d a f i I 0 1 y p 0 o f B A T. I f t h 0 C C P d o 0 s n o t 1 o c a 1 0 a b a t c h f i 1 0 t o 
match the f i 1 enarne spec i f i ed «, i t searches f or a command f i 1 e whose f i 1 etype 
is PEG» 


LOADING A PROGRAM 


E i t h 0 r t h 0 C C P o r a t r a n s i 0 n t p r o g r a m c a n 1 o a d a p r o g r a m i n t o m 0 m o r y w i t h 
th 0 BD08 Load and Exec:ute a Process Function (4B) described in Section 4« 7« 
After the program is loaded, the TPA contains the program segments <text, 
data, and bss), a user stack, and a base page. A base page exists for each 
program loaded into memory. The base page is a 256-byte data structure 
that 0 f in 0 s a p rogram ' s operati ng environment» The bas 0 page is 

initialized by the Load and Execute a Process <4B) function described in 
S e c:: t i o n 4« 7« G E M D 0 8 a 11 o c a t e s 256 b y t e s (m i n i m u rn) f o r t h e pro g r a m ' s u s e r 
st ac k» 
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2« 2» :L T h e I P A a n d B a s e P a g e I n i t i a i i z a t i o n 

The format of the Transient Program Area (TPA) that GEM DOB establishes for 
a n a p p 1 i c a t i o n p r o g r a m i s s h o w n i n F i g u r e 2 -1 * 


< --- H i g h TP A 

! < —. I n i t i a 1 S t a c k F* o i n t e r 

Applii 
cation 1 
User ! 

Area I 


BBS 
Data 
Tex t 


! Base Page! 


Figure 2-1. GEM DOS TPA Format 
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The initial stack pointer is directed at the top end of the? TP A» The base 
page c:ontai ns poi nters as described i n Section 2. 3» To i nsure max i mum 
c o m p a t i b i 1 i t y w i t h f u t u r e r e 1 e a s e s o f B E M D 0 S h i t i s r e c o rn m e n d e d t h a t 
memory not required by your program be Treed for use by other processes. 
T h e t o p o f t h e s t a c k s h o u 1 d b e m o v e d d o w n t o a n a c c e p t a h 1 e v a 1 u e a d j a c e n t 
to or within the hss, and an HBHRINK <4A) function should be per formed. 
If additional memory is needed later, perform an li_FREE <49) or M ALLOC 
<48) function to determine the amount of available memory (specify nbytes 

.1 for the !i_ALLOC call); follow this by another call to M.ALLOC to have a 

portion of that memory allocated. These operations reformat the TPA as 
s h o w n i n F i g u r e 2.2« 


<...... High TPA 

i 

i 

Aval 1ableI 
to other 1 
Processes I 

-.. < -.. S t a c k P o i n t e r 

Appli- I 
cation { 

User $ 

Area I 

iiss.7 

DATA S 
TEXT I 
BASE PAGE I 


Figure 


Adjusted TPA 
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2 * 3 BABE PAGE FORMA ! 

Table 2-1 lists the byte offset, length, value, and briefly describes the 
•fields in the base page that Load and Execute a Process <4B> initializes 
f a r t r an sient progr ams* 


Tab1e 2—1« Base Page For mat 

Base Page 

0 f f s e t L e n g t h V a 1 u e D e s c r i p t i o n 

00 4 p.lowtpa Base address of the TPA 

04 4 p.hitpa High address of the TPA + i 

08 4 p.tbase Base address of text (code) 

0C 4 p 11en Len g t h (in bytes) of t ex t (c ode) 

10 4 p.....dbase Base address of initialized data 

14 4 p.d len L.en g t h ( i n b y t es) o f d at a 

18 4 pbbase Base address of BBS uninitialized 

data 

1C 4 p.b 1 en Len g t h of BBS un i n i t i a 1 i z ed d at a 

2 C 4 p _ e n v P o i n ter t o t h e ea n v i r* o ri m e n t s t r i ri g 

x 80 x 80 p c m d 1 i n C o m m a n d 1 i n e i m a g e 

N o t e s A1 1 o t It e r b a s e p a g e f i e 1 d s a r e r e s e r v e d * 

2.4 E X ITI IMG TRANS I ENT PROGRAMS 

GEM DOS supports two ways of exiting a transient program and returning 
c: o n t r o 1 t o t h e C C P s 

* Interactively, when the user types Ctrl-C at the console 

* A p rogrammed ret urn t o t he CCP t h r oug h s 

— P r o g r a m T e r m i n a t e (0 0 ) 

— Terminate and Stay Resident (31) 

T e r m i n a t e P r o c e s s < 4 C) 

T y p i n g C t r 1 - C f r o m t h e c o n s o 1 e r e t u r n s c o n t r o 1 t o t h e C C P o n 1 y i f t h e 

pr ogr am uses any of the f o 11 owi ng f unc t i ons s 

•* R e a d C h a r a c t e r f r o m S t a n c3 a r d I n p u t D e v ice (01 > 

* Wr i te Character to Standard 0utput Device (02) 

* Read Character from Standard Input, No Echo (08) 

* Write String to Standard Output Device (09) 

* Read Edited String from Standard Input Device (0A) 

* Check Status of Standard Output Device (10) 

C t r 1 C t e r m i n a t e s e x e c u t i o n o f t h e m a i n p r o g r a m a n d a n y a d d i t i o n a 1 p r o q r a m s 
loaded beyond the CCP level. 


End of Sec t i on 
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GEM DOS COMMAND FILE FORMA] 


The GEM DOS command file format is the output of the EELMOD format 

conversi on uti1ity« EELMOD accepts a CP/M-68K- * f ormat relocatab1e output 

file generated by LINK68 or LOS8„ the BEM DOS linkers,, and converts it to a 

OEM DOS relocatable file. EELMOD, LINK68, and L068 are described in 
Section 6„ 

Command files consist of a file header followed by the tent and data 

segments. Optionally, a command file contains a symbol table and 
r e 1 o c a t i o n i n f o r m a t i o n I h e s e c o m p o n e n t s a r e s h o w n i n F i g u r e 3 -••• 1 a n d 

d esc rib ed in t h e foilowin g sec tion s„ 


File 

Header 

Text and 
Data 8egments 


Symbol Tab!e 
(if present) 

Eelocation Da ta 
(if present) 


Figure 3-1. BEM DOS Command File Layout 


3.1 THE HEADER AND PROGRAM SEGMENTS 

T h e fig u r* e 3—2 s h o w s the for m at of t h e h e a d e r f o r n o n - s e g m e n t e d 

< c:: o n t i g u. o u s) e x e c u t a b 1 e f i 1 e s« 


00H I 601AH ! 

02FI I Number of bytes in text segment I 
06H ! Number of bytes in data segment « 
OAH I Number of bytes in bss I 

OEH I Number of bytes in symbol table I 
12H I Reserved, must be 0 \ 

16 H I R e s e r v e d , m u s t b e O I 

1AFI « Reserved I 


Figure 3-2. 


BEM DOS Command File Header 
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The 14-word, 601 AH--type header denotes a relocatable 
contiguous text, data, and block storage segments* Note 
not support programs with non-contiguous segments* 


file that contains 
that GEM DOB does 


The f i e 1 ds at of f set s 12H, 16H, and 1 AH ar e r eser ved and 
text segment image follows the field at offset 1AH* 

T I"*! e t e x t s e g m e n t e o n t a i n s t h e e x e c u t a b 1 e i n s t r u c t i o n 
seg men t c on t ains t h e initia1iz ed d ata variab1es * 
seg me nt s must be r e1ocat ab1e„ 


must be zero. The 


code* The data 
The text and data 


The inclusion of the symbol table and relocation information in the command 
f i 1 e i s c o n t r o 11 e d b y t h e G E M D 0 8 1 i n k e r s, d e s c r i b e d i n 8 e c t i o n 6« 


3« 2 S V M B 0 L 7 A B L. E 

Th e symb o 1 t ab 1 e d ef i n es t h e symb o 1 s r ef er enced b y a c ornman d file* Eac h 
entry i n the symbol tab 1 e is assoc i at ed wi th an i ndex that :i nd i cates i ts 
entry nun§ber * Entr i es are numbered sequent i a 11 y start i ng wi th zer o« As 

shown i n F i. gur e 3—3, each sy mbo 1 t ab 1 e en t r y i s composed of seven words 

that describe the* symbol 's name, type, and value* 




1 

•+• Symbol 

i 

! 

"I" 

1 

i 

4 

I 

“1“ 

1 Name 

t 

! 

4 

i 

i 

4 

i 

i 

! Type 

» 

i 

t 

i 

•+• Value 

i 

1 

4 

j 

i 

_+ 


Figure 


8 y m b o 1 T a b 1 e E n t r y 
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T ab 1 e 3-1 cies c r i bes t h e f i e 1 ds of a symb o 1 t axb 1 e en t r y« 


Tab I 0 31» By rnb o 1 Tab 1 e En tr y F i e 1 d s 

F i e 1 d Definit 1 on 


Name Symbol name, nul1-padded right it 1 ess than ex ght 

characters,, 


Type 


Symbo 1 t ype as i nd i cat ed by t he t o 11 owi ng va 1 ues s 


0100Hs 
020OH r, 
040OHs 
080OH s 
100OHs 
2000Hs 
4000H s 
800 OHs 


bss-based re1ocatab1e 
t e x t - b a s e d r e 1 o c: a t a b 1 e 
d a t a - b a s e d r e 1 o c a t a b 1 e 
e x t e r n a i r e f e r e n c e 
e q u a t e d r e g i s t e r 
g1obal 
equated 
defined 


Value Symbol value where the value can be an address, register 

n u m b e r 9 v a 1 u e o f a n e x p r e s s i o n * a n d s o f o r t hN o t e t h a t t h e 
1 x nker s x nt er pr et t he va 1 ue when the symbo 1 i s ex t e?r na 1 
(0800H) as the sx z e of a common region. 


3.3 PRINTING THE SYMBOL TABLE 

Y o u c a ri p r i n t t h e s y rn b o 1 t a b 1 e o f a n o b j e c t o r c o m rn a n d f i 1 e w :i. t h t h e N M 6 8 

u t i 1 i t y« U e t h e f o 11 o w x n g c:: o m m a n d 1 x n e t o i n v o k e N M 6 8 s 

■C a !«• N M f x 1 e n a m e 

NM68 operaxtes on ohject or cornmand tiles. NM68 does not sort the symbo 1 s 3 

rather 9 i t pr i nts tTiem i n the order i n wh i ch they appear x n the file- Each 

si-ymbo 1 name i s> pr x nted ? f o 1 lowed by its va 1 ue and one or rnor e of the 

f o 11 o w x n g t y p e - d e s c r i p t o r s 2 

* e q u < e q u ax t e d ) 

^ global 

* e q u r e g (e q u a t e d r e g i s t e r ) 

* external 

* data 

* text 

* bss 

* a h s < a b s o 1 u t e) 


You can use the 1/0 redirection facility to store NM68 output in a file. 
To redirect NM68 output to a fi1e ? specify a greater-than—sign <>> and a 
•f : i 1 e spec i f i cat i on f o 11 owi ng t h e f i 1 ename f or whi ch NM68 x s to pr i nt the 
s y m b o 1 t a b 1 e« 
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3.4 RELOCATION INFORMATION 

The? re 1 ocati on i nt ormat i on i ndi cates the offset between 1 onqwords to be 
relocated• The offset from the beginning of the text segment to the fxrst 
1ongword that requires relocation is stored as a 1 ongword fol1 owlng the 
s y m b o 1 t a h 1 e. F o 11 o w i n q t h a t, b y t e s a r e u s e d t o s t o r e s u c c e e d i n g off se t s« 
I f t h e o f f s e t b e t w e e n t w o 1 o n q w o r d s t o b e r e 1 o c a t e d i s g r e a t e? r t I t a n 2 5 4 
b y t es „ t h e r e X oc at i on i n f or mat i on h as a b y t e of 1 f or each mu 11 i p 1 e of 254 
b y t e s h p 1 u s a b y t e w h o s e v a X u e i n d i c a t e s a n y r e m a i n d e r u A z e r o o f f s e t 
value indicates the end of relocation information. Note that GEM DOS does 
}"■] o t s u p p o r t 16 - b i t r e 1 o c a t a b X e? o h j e c t s. 

See Figure 3-3« Tab1e 3-2 1ists the relocation offset byte values and 
t h e i r m e a n i n g s« 


Symbol Tab!e 

Offset of 1st 
Longword to Re1ocate 
(Lo n g w ord Va1ue) 


Sueceeding Off sets 
(Byte Values) 

End of 

R e X o c a t i o n X n f o r m a t i o n 
CZero Byte) 


F i g u r e? 3 - 4. L o c a t i o n a n d F o r m a t o f E e 1 o c a t i o n I n f o r m a t i o n 

T a b X e 3 - 2« R e 1 o c a t i o n 0 f f s e t B y t e T a h X e 

Byte 
Val ue 

0 

X 

2 through 254 


* 

P J. u s 254 t i m e s t h e? n u m b e r o i : n 1 “ b y t e s t h a t p r e c e d e d t h is by t e« 

All relocation information is relative to the beginning load address (start 
of text)„ 


E n d o i S e c t i o n 3 
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SYSTEM FUNCTION CALLS 


T h i s s e c t :i o n d e s c. r i b e s t h © G E M D 0 S s y s t e m t u n c t i o n c a i 1 s, t h © i r e n t r y 

p a r a in e t © r s , r © t u r n v a 1 u © s, a n d © r r o r c o d e s- 

4.1 INTRODUCTION 

T' h © 6 E M D 0 E> s y s t © m c a 11 s ax r e c:l i v i d © d i n t q t h © f o 11 o w i n g c ax t © g o r i © s s 

Char ac t ©r D©vi c© I / 0 , F i 1 © liaxnag©m©n t, Dr i v© and Di rect a r y Manag©m©n t, 

F'rogram Control, Memory Management, and Time- Table 4.:L lists each OEM DOS 

system call according to these categories- Also listed in Table 4-1 are 
r © t © r © n c © s t o t h © s © c t i o n s o f t h i s c h a p t r t h i a t d © s c r i b e © ax c h c a 11 i n 
detai 1 « 


1" ax b 1 © 4 “ 1« G E M D 0 S 8 y stem C ax 11 C a t © q o r i © s 

Number 

C h a r ax c t © r D © v i c *© I / 0, 8 © c t i o n 4 - 4 

0 1 
02 
03 
04 
05 
06 
07 
OS 
09 
0A 
0B 
10 
11 
12 


F i 1 © M a n a g © m e n t, 8 © c t i o n 4« 5 

1A 
2F 
3C 
3D 
3E 
3F 

40 

41 

42 

43 

44 

45 

46 
4E 
4F 

56 

57 
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} a b 1 0 4 1« (c o n 1 1 n u 0 d) 

Number 


D r i v 0 a n d D i r 0 c t o r y M a n a g 0 m 0 n t«, 8 0 c t i o n 4« 6 

OE 

19 

36 

39 

3 A 
3B 

47 

P r o g r a rn C o n t r o 1 ,, S 0 c t i o n 4.7 

00 
”•.< inr 

30 

31 
35 
4B 
4C 

M 0 m o r y li a n a g 0 rn 0 n t q 8 e c t i o n 4« 8 

48 

49 

4 A 

T i rn 0 , 8 0 c t i o n 4« 9 

2 A 
2B 
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4.2 FUNCTION CALL PARAMETERS 

T h e G E M D 0 8 p a r a m 0 1 e r - p a s s i n g c o n v 0 n t i o n s u p p o r t s f u n c t i o n c a 11 r e 1 0 r 0 n c 0 s 

•f r 0 m C a n d o t h 0 r h :t g h - 1 0 v 0 1 1 a n g u a g e s« 

A f u n c t i o n c a 11 r e f 0 r 0 n c 0 f r o m a h i g h ~1 0 v 0 1 1 a n g u a g e c 0 n s t r u c t s a p a r a m e 1 0 r 

block that contains the number of the function call, any necessary 

param0 1 0rs , and other r0 1 0vant data (such as a driv0 c0d0 0r fi 1 & hand 1 0) 

and perf 0rms a TF<AP # 1 i nstruction. GEM D 08 th0n pr0c0ss0s th0 r0f 0r0nc0 
a n d 0 x 0 c u 1 0 s t h 0 a p p r 0 p r i a 1 0 a c t i 0 n s« 

The general format of a GEM DOS function call parameter block is shown in 
F'i gu.re 4 - 1 » 


{ F u n c t i 0 n h 4 u m h 0 r ! 


Low Memory 
(Parameter 
Bloc k Addr ess > 


! 1 st Parameter ! 

I 2 nd Parameter I 

\ 3 r d P a r a rn 0 1 0 r I 


•+•—---- --- — H i g h m 0 m o r y 


F : i g u r 0 4 ~ 1 . F u n c t i 0 n C a 11 P a r a m 0 1 e r B 1 a c k F c:> r m a t 


The positions of the parameters and the function number in Figure 4-1 
conform to the order in which they are placed on the stack by the C 
1 an g uag e» Spec i f i c a 11 y <{ t h 0 C c0d e s 

C A L L < f : u n c t i 0 n n u m b 0 r , , P i P 2 , P 3 , P n ) 

loads the F'n parameter into the parameter block first, followed by P 3 
through PI, until the function number is the last entry in the parameter 
b 1 oc k 
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4.2.1 GEM DOS File and Device Handles 

F_CREATE (30, F_OPEN (3D), and F_DUP (45) return a 16-bit binary 
identifier value in register DO.L. This identifier is called a “handle.** 
The handle is used to later identify files or devices that have been opened 
o r c r e a t e d w i t h t h e s y s t e m c a 11 t h a t o r i g i n a 11 y r e t u r n e d i t« A11 h o u g h a 
h an d 1 e i s 16 b i t s I o n g , y o u r p r o g r a m s h o u 1 d t e s t t h e e n t i r e 1 o n q w o r d v a 1 u e 
returnecl i n DO „ L to deter rni ne i f the va 1 ue represents an error code or a 
valid handle» 

T a b 1 e 4—2 1 i s t s t h e h a n d 1 e s t hi a t i d e n t i f y d e v i e e s » 


Table 4-2. GEM DOS Device Handles 

Hand 1e 

Val ue Device 

4 S t a n d a r d 1 i s t d e v i o e 

0 u t p u t c a n b e r e d i r e c t e d,« 

3 S t a n d a r d A U X d e v i c e 

1 / O c a n b e r e cl i r e c t e d« 

2 S t andar d er r or device (std Err) 

I /0 c:an be redirected „ 

1 S t a n d a r d o u t p u t d e v i c e (s t d 0 u t) 

0u t p u t c a n r e cl i r ec t ecl a t 
t h e c o m m a n d 1 :i. n e * 

0 S t a n d a r cl i n p u t d e v i c e (s t d I n ) 

I n p u t c a n b e r e d i r e c: t e d a t 
11" ! e c: o rn m a n d .1. i n e« 


Your program can use these handles without previously opening them. Your 

P r o q r a rn c a n r e d i r e c t I / O f o r t h e s e d e v i c e s w i t h F.... P“ 0 R C E ( 4 6) « 

Y o u r p r o g r a rn c a n o p e n t h e f o 11 o w 3. n g d e v i c e s b y s}:) e c .i f y i n g a d e v x c e n a m e 

w i t h t h e F.... 0 P E M (3 D) f u n c t i o n s 

* T hi e c o n s o 1 e d e v i c e ,, C 0 N s 

* T h e a u h i 1 i a r y d e v i c e , A U X s 

* T h e 1 i s t d e v i c e P R N is 

* T h e b i t b u c: k e t h N U L. s 

N o t e t h a t I / 0 f o r t h e d e v i c e s o p e n e d b y n a rn e c: a n n o t b e r edi rested * 8 e e t h e 

descriptions of FOPEM (3D) and F FORCE (46) in Section 4.5. 


4« 2.2 R e t u r n V a 1 u e s 

0 E M D O 5 f u n c t i o n c: a 1 Is re t u r n a 11 b y t e H w o r d , a n d 1 o n g cl a t. a i n r e g i s t e r D (j 
b y d e f a u 11. T h o s e f u n c t i o n c a 11 s t h a t r e t u r n m o r e i n f o r m a t. i o n p 1 a c: e t h e 
address of an information return buffer in DO or fill in a caller-specified 
b u f f e r „ T h e i n d i v i d u a 1 f u n c t i o n c a 11 d e s c r i p t i o n s e k p 1 a i n h o w d a t a r e t u r n s 
to the caller,, 
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4» 2 . 3 Er r or Eet u. r n Cod es 

T h e G E M D 0 S f u n c i i o n c a 11 s p 1 a c e a n e g a t i v e n u m b e r i n D 0 t o i n d i c a t e a n 
e r r o r r e t u r n « S e e t h e i n d i v i d u a 1 f u n c t i o n c a 11 d e s c r i p t i o n s f a r m o r e 
c o m p I e t e i n f o r m a t i o n 

"T a b 1 e 4 - • 3 I i s t s t h e e r r o r c o d e s r e t u r n e d b y t h e G E H D 0 E> f u n c t i o n e a 11 s i n 
r e q i s t e r D 0. L. A1 s o i x s t e d i n T a b 1 e 4 - 3 a r e t h e n u m b e r s o f t h e P C D 0 S 
f unct x a n c::a 11 error c:odes that c:orrespond to the GEM D□ 8 error codes. 


T a b 1 e 4—3. B D 0 S Err o r C a d e s 


GEM DOS 
Return 

PC DOS 
Equiv» 

Code 

Error Report 

•-32L 

1 

EINVFN 

Invalid function 

—33L 

2 

EFILNF 

F i 1 e n o t t o u n d 

-34L 

..... 

EPTHNF 

P a t h n o t f o u n d 

--35 L 

4 

ENHNDL 

N o 1") a n d 1 e s 1 e f t (t a o m a n y o p e n 

-36 L 

5 

EACCDN 

A c: c e s s d e n i e 

-37L 

6 

EIHNDL 

!i‘ n v a 1 i d h a n d 1 e 

-39L 

8 

ENSMEM 

I nsu f 1 1 c i en t. memor y 

—40L 

8 

El MBA 

I n v a 1 i c::l m e mi o r y b 1 o c k a d d r e s s 

—46L 

15 

EDRIVE 

I n v a 1 :L d d r :i v e s p e c i t i e d 

-491.... 

18 

ENMFIL 

No more files 

•-64L 

-65L 

'tj c>L_ 

-67L. 


ERANGE 

EINTRN 

EPLFMT 

EGSBF 

restrictions) 

Range error 

I n t e r n a 1 e r r a r 

1 n v a 1 i d p r o g r a m 1 o a d f o r m a t 
Setbl oc; !•:; f ai 1 ur e (due t o gr owt h 
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4«3 GEM DOB SYSTEM CALL SUMMARY 

T a b 1 e 4 -• 4 I i s t s t h e h e x a d e c i m a 1 n u m b e r a n d rn n ev rn o n i c o t e a c h G E M D 0 S s y s t e m 

•f u. n c t i o n c: a 1 1 . T h e t a b 1 e i n c 1 u d e s t h e p a r a rn e t e r s a p r o c e s s rn u s t p a s s t o 

t h e s y s t e rn c a 11 a n d t hi e v a 1 u e s t he? s y s t e m r e t u r n s t o t h e c a 11 i n g p r o c e s s« 



Tab! e 4~~4» 

GEM DOS System Call Summa 

ex 

Mnemonic 

1 n p u t P a r a rn e t r s 

0 

P^TERMO 

none 

i 

C ...CON IN 

none 

2 

C...CQN0UT 

Character 

3 

C A Li X IN 

none 

4 

C A Li XQ U T 

Character 

15 

C.....PRN0UT 

Character 

6 

C RAW 10 

F F / C h a r a c: t e r 

7 

C.RAWCIN 

none 

8 

C NEC1N 

none 

9 

C.CONWS 

* C h a r a c t e r 81 r 1 ri g 

A 

C CONRS 

* I n p u t B u f f e r 

B 

C.CON 13 

none 

E 

D.SE T DRV 

Drive Code 

i 0 

C_C0N0S 

n on e 

11 

C.PRNOS 

none 

12 

C_AUXIS 

none 

13 

C...AUX0S 

none 

19 

D 6ETDRV 

n on e 

1A 

F.SETDTA 

D T A < L o n q V a 1 u e) 
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T a b 1 0 4 4. < c o n t i n u e d ) 


lineman :i. c 


1 n p la t P a r a m e t e r s 

S.SETVEC 

Address 


Vector# 

T_6ETDATE 


none 

Bits 0-4 = d a y < 1- 3 1 ) 

B 1 1 s 5 - 8 = m o n t h < 1 -12) 

B i t s 9 -15 - y e a r (0 -119) 

SETDATE 
Bits 0-4 - 
Bits 5-8 - r ~ 
Bits 9-15 =■ 

(1-31) 

(1-12) 

(0-119) 

Date Words 

T_GETTIME 


none 

B i t s 0—4 =» 2 - s e c i n c: r e m e n t 
B i t s 5 — 10 m i n u t e s 

B its 10 15 h o u. r s 

T_SETTIME 
Bits 0-4 
Bits 5-10 * 
Bits 10-15 

T i m e W a r d (b i n a r y) s 

2 - s e c i n c r e m e nt s 
■ minutes 
hours 

F J3ETDTA 


none 

S ...VERSION 


none 

P.TERMRES 

Exit Code 


Memory Size 

S_ 6ETVEC 


Vector# 

D. FREE 
Drive Cade 


*;■ R e t u r n B u t f e r 

# o f CI la s t e r s 
& y t e s / 8 e c t o r s 

S e c t s / C i u s t e r s 

D 0 „ L «= E r r o r C o d e 

D .CREATE 


*Path String 

D _DELETE 


*Path String 
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Table 4—4- 

(continued> 

Hen 

Fine mom c 

I n p u t P a r a m e t e r 

3B 

D_SETPATH 

*Path String 

3C 

F.CREATE 

Attritouts 

*Path String 

3D 

F.OPEN 

Access Mode 

*Path String 

3E 

F.CLOSE 

HandIe 

3F 

F.READ 

# of Bytes 
*Buffer 

Handle 

Error Code 

40 

F.WRITE 

# of Bytes 
•#Buff er 

Handle 

Error Code 

41 

F.DELETE 

*Path String 

42 

F.SEEK 

HandIe 

Node Vaiue 

Offset 

Error Code 

43 , 

F.ATTRIB 

Mode Value 

Attr i bu.te 

*Path String 
Error Code 

44 

F I0CTL 

Subfunction # 


H a n die o r D r* i v e C o d e B i t M a p o f D e v i c e I n f o r m a t i o n 
B y t e C o u n t o r B i t M a p 

* B u f f e r it o f B y t e s R e a d / W r i 1t e n 

I/□ Status 
Media Type 

45 FDUP HandIe 

Error Code 

46 F FORCE Standard HandIe 

D u. p 1 i c a t e H a n d 1 e 
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Hen 
4 7 

48 

49 
4 A 

418 

4C 

4E 

4F 

56 

57 

C o n v e n t i o n s u s e d 

# 

Ad dr = 

DTA 

Handle *= 
Path Strinq 


T a b i e 4—4 < c o n t i n u e d) 


lineman ic 

D GETPATH 
Drive Code 

M.ALLOC 

( f o r # o f a v a i 1 a b 1 e 


M.FREE 

M.SHRINK 

# of bytes to keep 
PJEXEC 

*F‘ath Stri nq 
♦Command Tai1 

* E n v i r a n m e n t S t r i n g« 


I n p u t P a r a m e t e r s 
*Path Buffer 


# of Bytes or ~~1L 
bytes) 

0 on Failure 
Hernory BIoek Ad d r 
li e m o r y B1 o c k A d d r 


Load Vaiue 
Base? Page Ad dr 
Error Code 


P.TERM 

F 8FIRST 
Attribute 

F_SNEXT 

FORENAME 

* P a t h S t r i n g < N e w 

F^DATIME 
Buff er 
Hand!e 

Get/Set F1ag 


S t a t u s C o d e 
*Path Strxng 

none 

*Path String 
Name) 

* T i m e / D a t e B u f f e r 


in fable 4—4s 

Pointer to 

Number- 

Address 

D i s k T r a n s f e r A d d r e s s 
F i 1 e o r D e v i c e H a n d 1 e 

d i r e c t o r y p a t h a n d f i I e n a m e 
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4.4 CHARACTER DEVICE I/O FUNCTIONS 

Table 4-5 lists the number, mnemonic,, and name of the GEM DOS system 
■f u n c t i o n d e s e r i b e d i n t h i s s e c 11 o n „ 


T a b 1 e 4 - 5 „ C h a r a c: t e r D e v i c:: e I / 0 F u n c: t i o n s 


Hex 

Mnemonic 

01 

c 

CON IN 

02 

C„ 

CONOU! 

03 

C.. 

AUXIN 

04 

C (> 

All X OUT 

05 

c 

.PRNOUT 

(j 6) 

c. 

.RAW10 

07 

c 

.RAWCIN 

08 

c 

. NECIN 

09 


_C0NWS 

0 A 


CQNRS 

OB 

c 

CON IS 

10 


CONOS 

11 


PRNOS 

12 

c’ 

AUXIS 

13 

c 

AUXOS 




0 0 m D 0 s D o c u rn 0 n t a t i c::« n 
Serial Number 006738 


F u n c t i d n 0.1. s R e a d C h a r a c 1 0 r t r 0 rn 81 a n d a r d I n p u t D 0 v i c 0 


C Interfaces 


LONG 

c con1n () 


P a r a m 0 1 0 r B1 0 c: k 2 


0 ! t u n c 1 1o n cod 0 0 i ! 


R e t u. r n V a 1 u 0 s s 
R 0 g i s 1 0 r D 0 „ L. 2 

( i n X 0 a s t s i g n i f i c a n t b y t e) 

Description C.CONIN reads a charactor from the standard input device 

and echoes it to the standard output device. 

I t a 6EM» n « VDI c 0 rnpati h 1 e con 00 i e is the standard i nput 

device, C.CONXN p1 aces the consol 0 scan code in the iow 

b y 1 0 0 1 t h 0 h i g h w 0 r d r 0 1 u r n 0 d i n D 0« 01 h 0 r wise, 1h i s b y t e 

i s s 0 1 t o C> 0 u 8 e e F i g u r 0 4 - 2« 

I f C C 0 NIN r 0 a d s a C t r 1 ~~ C c h a r a c t e r H i t i 1 u s h 0 s t h 0 

type-ahead buffer and executes a warm boot operation. 


Hh Hw Lb Hw Hb Lw Lb Lw 

! 00 ! code I 00 I char i 
! { or 00 1 ! ! 


F i g u r 0 4 - 2« Jj 0 C c:« n t e n t ns R e t u r n e d f r o m C _ C 0 NIN 
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Fli nct i on 02 s Wr i te Character to h tandard 0uput Devi ce 


C Interfaces 

VO ID 

cconout <c) 

WORD c:; 

«• 


P a r a m e t e r B1 o c k s 


0 1 f u n c t i o n c o d e 0 2 I 




Pararneter s s 

c Character to be disp1 ayed in Iower 8 bits, 

u p p e I* " 8 bit s s h o u 1 d b e s e t t o z e r o 

Descriptions C.CONGOT displays the character contained in the lower 8 

b i t s o f t h e c p a r a rn e t e r o n t h e s t a n d a r d o u t p u. t d e v i c e „ T o 
e n s u r e c o rn p a t i b i 1 i t y w i t h f u t u r e e x t e n s i o n s t o t h e 16 - b i t 
ch a r acte r set« the up per 8 bits of c shou 1 d be zero« 

C C 0 N 0 0 T t r a n s 1 a t e s t a b c: h a r a cte r s i n t o c o 1 u m n s o f e i g h t 

c h a r a c t e r s« I h i s f u n c t i o n a 1 s o c h e c k s f o r C t r 3. - 8 (s c r o 11 

s t o p > h C t r I -• Q < s t r a t s c r o i 1 ) * a n d C t r 1 ■•••• P < p r i n t e r s w i t c h) 
and processes Ctrl-C, which aborts the operation and warm 
b o o t s t h e s y s t e m « 

Fun c t i on 0 3 s Read Ch ar acter f r om St an d ar d Aux i 1 i ar y De v i c e 


C Interfaces 


LONG 

c a uh i n <) 


P a r a m e t e r B1 o c k s 


0 1 f u n c t i o n c o d e 0 3 I 


R e t u r n V a 1 u e s s 
Register DO«L s 


Description 


C A U XIN r e c e i v e s a c: h a r a c t e r f r o m t h e a u x i 1 i a r y p o r t a n d 

r et ur n s i t i n DO „ L« 
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Fun c t :i. on 04 s Nr i t e Ch axr ac t er t o St an d ar d Auk i 1 x ary Dev 1 c e 

C Interfaces 

VOID 

e.a.UKQu.t (e) 

'""word c j 


P a r a m e t e r B 1 o c k s 


0 I f u n c t i o n c: o d e 0 4 ! 

t .... j 

j-:. ! «... i 


C h a r ax c 1 0 r t o b 0 © 0 n t t o t h e a u k 1 1 i a r y p 0 r t 1 n 

1 o w 0 r 8 b x t ih> 9 u p p 0 r Es b i t s © h a u 1 d b e © 0 1 t a z e r a 


C AUX 0 UT s0nd© th0 c.haracter contax n0d x n t.h0 1 ow0r 8 bx ts 

0 f t h 0 c p a r ax mete r t o t h 0 a u. k i 1 x a r y p 0 r t« T o e n s u r 0 

c 0 rn p a t x b i I i t y w i t hi f u t u r 0 0 k 1 0 n s i 0 n © 1 0 t h 0 i 6 - b x t 

chaxracter ©et ? the upp0r 8 bx ts 0f c sh«::«u 1 d be zero. 

F u. n c t x 0 n 0 5 s W r i 1 0 C h a r a c : 1 0 r 1 0 S t a n c i ax r d P r i n t D e v i c 0 

C Interface!! 

VOID 

c.prnout (c:) 

WORD c n 


P a r a m 0 1 e r BI 0 c: k s 

0 1 f uncti0n c0de 05 I 


P a r ax mete r s s 

c Char axe ter to be sent to the standard 

d e v .i. c e x n 1 0 w e r 8 b i t s 9 u p p e r 8 b i t s 

Descriptions 


printer 

should be set to zero 


Parameters! 


Descriptions 


C P R N 0 U T s 0 n d s t h 0 c h a r a c t. 0 r c 0 n t a i n e d x r x t h 0 1 0 w 0 r 8 b x t s 
a f the c parameter to the standard printer device. T0 
ensu.r 0 cornpat 1 b i 1 x t y wx t h f utur 0 ex t ensi ons t.0 t he 16 -b i. t 
character set 9 the upp0r Ei bxts a f c sh0uId be zero» 
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F Lt n c t i o n 0 6 s R a w I / 0 t o S t a n d a r d C o n b o 1 0 

C Interfaces 

LONG 

c r a w i o < p a r m) 

WORD par mr, 

r 

X 


P a r a rn e t e r B 1 o c k s 


0 1 f u ri c 11 cd n c o d e 0 6 i 
2 ! parm I 


Parameters! 


p a r rn S p e c i f i e b t h e o p 0 r a t i o n t o b 0 p 0 r f o r rn 0 d s 


F F 1 o r e a d a c h a r a c 10 r f r o m S t d I n 
char Character to bee sent to StdOut 


(param « FF) 


R 0 1 u r n V a I u 0 b s 
Regis ter DO« L s 


0 C h a r a c 10 r n o t a v a 11 a L 1 0 
(parm - FF) 


D 0 b c r 1 p t i o n s I f p a r m i e F F ,, C _ R A W10 r 0 a d b a c h a r a c 1 0 r f r o m t h e? b t a n d a r d 

i nput devi ce and returns :L t i t D0„ W„ If a charac1 0 r 1 0 not 
a v a i I a b 1 0 f r o m t h e? s t a n d a r d i n p u t d 0 v i c 0 D 0 „ L r 0 1 u r n b z 0 r o. 

I f p a r m 1 s n o t F F , C.R A W 10 ax s s u m e s t h e w o r d c: o n t a i n s a 

chaxraxcter tc j be sent to t h 0 standard output d 0 vice, 

F u n c t i o n 0 7 s R a w 1 n p u t f r o m S t a n ci a r d I n p u t D e v i c e 

C Interfaces 

LONG 

c^rawcin () 


P a r a m 0 1 0 r B !i. o c k s 

0 ! f u n c 1 1 o n c o d 0 0 7 i 

R e t u r n V ax 1 u 0 b s 
R egi b ter DO«L s 

D e s c r i p t i o n s C R A W CIN r 0 a d s a c: h a r a c: 1 0 r f r o m t h 0 b t a n d a r c j i n p u t d 0 v 1 c e 

an d r 0 1 urn s i t i n DO „ L w i t h out ec h o i n q it to Bt an d axr d 

o u t p u t ci e v i c e« 

C _ R A W CIN d o 0 b n o t j;::* 0 r f o r rn a c h 0 c k f o r c o n t r o 1 c h a r a c 1 0 r b „ 
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F u n c t i o n 0 8 s R e a d 0 h a r a c t e r from S t a n ci a r d I n p u t, M o E c h o 


C Interfaces 


LONG 

c.necin <) 


P a r a m e t e r B 1 o c k s 


0 1 f u n c t i o n c: o ci e 0 8 I 


R e t u r n V a 1 u e? b s 
R egister DO.L s 

Descriptions C NE.CIN reads a character from the standard input device 

a n d r e t u r n s it i n D 0. L w i t h o u t e c h oing i t t o s t a n ci a r d 
o u t p u t ci e v i c e« 

Controi c:harac:ters are i nterpreted by thi s f la nct i on and 
have their proper effect; see “Line Editing Commands 11 in 
S e c t i o n 1 o f t h & 6 E !i D 0 9 IJ s e r s 6 u i d e« 


F u n c t i o n 0 9 s W r * i t e 81 r i n g t o S t a n ci a r d 0 u t p u t D e v i c e 


C Interfaces 

VOID 

c.conws <p) 

B Y TE *p 5 


P a r a m e t e r B 1 a c k s 


0 i f li n c 1 1 a n c o d e 0 9 I 

•"‘.I l i 

.C. I ! 

+ P •+• 

4 { ! 


P a r a m e t e r s s 

p P o i n t s t o a n u i 1 ~ t e r m i n a t e d s t r i n g o f c h a r a c t & r s 

t o b e w r i 11 e n t o t h e s t a n d a r ci o u t p u t d e v i c: e 

D e s c r i p t i o n s C _ C 0 N W £> t r a n s m i t s t h e n u 11 -1 e? r m i r j a t e d c: h a r a c t e r s t r i n g 

pointed to by p to the standard output device, character by 
c h a r a c t e r « T h i 3 f u n c t i o n a I s o p r o c e sse?s C t r i — C , w l" i i c h 

a b o r t s t h e o p e r a t i o n a n ci w a r m b o o t s t h e s y s t e m« 
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F u rx c: t 1 o n 0 A s R 0 a d E d i 1 0 d 81 r * i n g f r 0 n i S t a n d a r d I n p li t D 0 v :i. c: 0 


C Interfaces 

VO ID 

c conrs () 

BYTE *p; 


! ::<i a r a m 0 1 0 r BI o c k s 

I f u n c t i o r* c o d e 0 A I 


P a r a m ex t0 r 0 3 

p P o i n t s 1 0 a n i n p u t b u f f0 r 

D 0 sc. r i p t x on s C C 0 NRS r 0 ad s c h ar a. c 1 0 r is f r am t h e c a. 11 osr s d 0 f au 11 i np li t 

d 0 v i c 0 a n cl w r x 1 0 s t. h e m t o t h 0 i n p u. t h u t f 0 r p 0 i n t e d 1 0 h y 
th0 p paraxm0 1 0r „ The tormat 0 1 the xnp li t buf fer is sh0wn 
in Figure 4 - 3 . 


0 


4 


0 1 2 MAX - 1 

! MAX I NCRARB ! CHARACTERS . . .I i ODH i 

Fxgure 4—3. C.CONES Occurrence 


B y t e 0 o f t h e x n p u t b u f t 0 r s p 0 c if i. 0 s t hi 0 n u m b 0 r 0 1 
characters the buffer can hold, C_C0NES sets byte 1 to the 
n umIs osr 0 f char ac 1 0 r s r 0 ce i v 0 d « Th i s va 1 u 0 d 00 s not inci li d 0 
t h 0 1 0 r m i n a t o r c h ax r ax c: ter, a c a r r i a g 0 r 0 1 u r n < 0 D H) * C C 0 N F\* E> 
w r x t e s t h e c h a r a c 1 0 r s x t r e ax d s f r q m t h os s t a n c j a r d x n p u t 
d 0 v x c ex 1 n 1 0 t h os b u f f ex r b 0 g x n n x n g a\ t t h ex t h i r c:l b y t ex. W h 0 r*i 
11" ! 0 s y s t os rn c a 11 r e a d s ax c a r r x a q 0 r 0 1 li r n , x t s 1 0 p s writ! n g 
to the bLif ter« 

W h 0 i " i t h os x r x p u t b u. f f os r f x 11 s 1 0 0 n 0 less t h a n t h ex v a 1 u 0 0 f 

byte 0, C.COMRS ignores additional input and sounds the 

b 0 11 u r' ! t i 1 i t r 0 a d s a c a r r x a g 0 r 0 1 li r n« 

C _ C 0 N R S p 0 r f 0 r m s 1 i n 0 —e d i t i n g f u n c t i 0 n s o n t h 0 c: h a r a c t. 0 r s 
as th 0 y arex read f rom th 0 c 0 ns 0 1 e <Backspace, Ctr 1 • E , 
Ctr 1 -Q , Ctr 1 - R , Ctr 1 8, Ct r 1 -U , Ctr 1 X) and posr f 0 r rns a 
war rnboot on Ct r 1 - C i npLit« 
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F u. n c: t i o n 0 B s C h e c k 91 a t u s o f 81 a n d a r d I n p u t D e v i c e 


C Interfaces 


LONG 

c conis (int) 


P a r a m e t e r B I o c k s 

0 1 t unction code OBi 

R e t u r n V a 1 u e s s 
R e g i. s t e r D 0 « L 2 

0 If n o charac ter av ai1 able 

D e s c r i p 11 o n 2 C C 0 N IS c h e c k s t h e s t a t u s o f 1e c a lie r s s t a n d ax r d :i. n p u t 

d e v i c e t o d e t e r m i n e i. f a c: h a r a c t e r i s r e a d y t o b e r e c e i v e d « 

F u n c t i o n 10 s C h e c k S t a t u s o f 8 t a n d a r d 0 u. t p u t D e v ice 

C Interfaces 

LONG 

c conos i) 

1 

j* 

P a r a fix e t e r B X o c k s 

0 1 t u n c 1 1 a n c o d e 10 \ 


e t u r n V ex j. u e s s 
R e g i s t e r D 0« L 2 

0 I f c o n s c:« 1 e u. n a v a i. I a b 1 e 

D e s c: r i t i o n s C _ C 0 N 0 S c: h e c k s t h e b t a t u. s o f t h e c a 11 e r s c o n s c::« I e d e v i c: e t o 

determine if it is ready to receive a character« 

Th i s f unct i on a 1 so pr ocesses Ct r I -~C, 
o p e r a t i o n a n *:j w a r m b o o t s t h e s y s t e m« 


w h 1 c h a b o r t s t h e 





G e m D □ s D o c u m e n t a t i q n 
Seria1 Number 006738 


F u. n c t i □ n i 1 s C h e c k S t a t u s o t S t a n d a r d P r i n t D e v i c e 


C I n t 0 r f a c e s 


LONG 
epr nos () 


P a r a m e t e r B1 o c k s 


0 I t la n c t i o n c: o d e 111 


0 I f p r i n t e r u n a v a i. 1 a b 1 e 


R 0 1 u r n V a i u e s s 
Register DO« Ls 


D e s c r ip t i o n s C P R N 0 8 c h e c: k s t h e s t a t la s o f t h e p r i n ter d e v ice t o 

determine if it is ready to receive a character. 


F la n o t i o n 12 s C h e c k 81 a t la s o f 81 a n d a r d A u x i 1 i a r y D e v i c e I n p u t 


C Interfaces 


LONG 
c auxis <) 


P a r a m e t e r B1 o c k s 


0 » f u n c t i c.) n c a d e 12 i 


R e t la r n V a 1 la e s r, 
Register D0« Ls 

0 If no char ac t er av ail ab1e 

D e b c r i p 1 1 o n C A U X 18 c h e c k s t h e i n p u t s t a t u s o f t h e o a 11 e r s s t a n «d a r c:i 

a lax i 1 i ar y d e v i c e t o d et er m i n e i f a c h ar act er i s read y t o b e 

received. 








S e m D o s D o c u. m e n t a t ion 
S e r i a 1 N u m b 0 r 006738 



F : * a r a m e t e r B1 o e: !•••: s 





0 ! 

H — 

function codi 

a 13! 

R e t u r n V a i u e s s 
R e q 1 s t e r D 0« L s 

0 

* 11 :i. t i s u. n a v a i 1 

ab 1 e 



Descriptions 

C.A U X 0 8 c h e c k s 

the status 0 * 

f t i 'i e c a i 1 e r s a 

u k 1 i i a r y d ea v i c e 


10 deter mi ne :t f 

it is ready 

10 r e c e i v e a e h 

aracter„ 
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4* 5 FILE ACCESS FUNCTIQNS 

T a b 1 e 4 - 6 1 i s t s t h e n u m b e r , m n e m o n i c , a n d n a m e o f t h e 6 E M D 0 S s y s t e rn c a 11 
d e s c r i b e d i n t h i s s e c t i o n« 


T a b l e 4 - 6« F i 1 e A c cess F" u n c t i o n C a 1 i s 


H e k M n e m o n i c: 


1A 

F 

SETDTA 

2F 

F 

_GETDT A 

•J 1 w 

F 

^CREATE 

3D 

F 

.OPEN 

3E 

F 

.CLOSE 

3F 

F 

READ 

4 0 

F 

WRITE 

41 

F 

.DELETE 

42 

F 

.SEEK 

43 

F 

Iattrib 

45 

p 

_DUP 

46 

F 

.FORCE 

4E 

F 

SFIRST 

4F 

F 

~SNEXT 

56 

F 

RENAME" 

57 

p 

DAT IME 
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F u n c t i q n i A s 8 e t D i s k T r a n s f e r A d d r e s s 


C Interfaces 

VO ID 

f setdta (b) 
BYTE *b; 


P a r a m e t e r B1 o c k s 

0 ! f u n c t i o n c o d e 1A I 

4 . ad dr + 

4 I I 


Parameterss 

a d d r A d d r e b s o f D T A t::* u f f e r 


D e s c: r i p 1 1 o n s T h e 4 4 ~ b y t e b u f f e r w h o s e 1 o c a t i o n i s s p e c i f i e d w i t h 

F_SETDTA may begin on an even or add address- F_3FIRST 

< 4 E) a n d F.S N E X T (4 F r > u s e t h e D T A t o r e t u r n f i i e s e a r c h 

.i n f or ma t i on« 

I f y o u d o n o t s e t t h e D T A, G E M D 0 S u s e s t h e d e f a u 11 0 T A a t 

C3 f f s e t 3 0 i n t h e B a s e P a g e „ F.G E T D T A (2 F) r e t u. r n s t h e 

c u r r e r i t I o c a t i c:) n o f t h e D T A b u f t e r » 

Function 2F s Get Disk Transfer Address 


C Interfaces 


LONG 

f _getclta i ) 


P a r a rn e t e r B i o c: k s 


0 I i u n c t i o n c c« d e 2 F I 


E e t u r n V a I u e s s 
E e g i s t e r D 0« L s 

Descriptions F r GET'DTA returns the current address of the DTA buffer in 

D 0 » L „ Y o u c a n s e t t h e D ]" A b y c: a i 1 i n g F _ E> E T D T A < 1A) « N o t e 
that only F BF'IEST (4E) and F SNEXT (4F) use the DTA to 
r e t u r n ± i 1 e s e a r c h i n f o r m a t i a n * 









6 e m D q s D o c u rn e n t a t i o n 
SeriaI Number 006738 


F u n c t i o n 3 C s C r e a t. e a F i 1 e 


C Interfaces 


LONG 

f _ e r e a t e ( n a m e«, a 1 t r ) 

BYTE *name5 

WORD attr? 


P a r a (in e t e r B1 o c k s 


0 I Funct i on cq de 3C I 

■ t i j 

u'l i ! 

+ name *+• 

4 ! ! 

6 I attr I 


Parameters! 


n a m e P o i n t s t o a n u 11 -1 e r m i n a t e d s t r i n g t h a t s p e c: i f i e s 

the drive, path, and name of the file to be created 

attr Specifies the file s attributes: 


0:1 Read •-•on 1 y 

02 Hidden 

04 System , Hi cJden 

0 8 E n t r y i s a v o 1 u m e 1 a b e i 

R e* t u r n V a 1 u e s s 
Register D0.L s 

- 3 4 L < P a t h n o t f o u n d) 

-35L (No handles left) 

3 6 L.. (A c c e s s D e n i e d) 


Desertptions 


F C R E A T E r e t u r n s e r r o r c o d e ••••• 3 6 L (A c c e s s D e n i d) t c::« 
i n d i c a t e t h a t a f i 1 e w i t h t h e n a m e s p e c i f i e d :i. n t h e n a m e 
string a1ready e k ists or that the directory is fu11» 









^ri 


G e i t *i D q s D o c u m e n t a 1 1 a n 
8 e r i a i N u m b e r 0 O 6 738 


F u n c t i o n 3 D 5 0 p e n a F i 1 e 


C Interfaces 

LONG 

f.o p e n (p n a m e . 7 m a d e) 

BYTE" p name?, 

WORD mode; 


F‘ a r a m e t e r B1 o c 1-.: s 



•{••••■ 

-- { . . .. 

..-I- 


I 

f u n c t .i o n c o d e 

3D! 


y 

----H.. —. 

1 


-i- 

pname 

8 

4* 

4 

t 

8 


i 

1 


••I— 

---f.-.. 

.— 1 “ 

h 

1 

1 

mode 

i 


4- - 

- ---*--— 

.. ~j- 


Parameters! 


p n a m e P o i n t s t o a n u. 11 -1 e r rn i n a t e d s t r i n g t h a t s p e c i ties 

the dr i ve, path , and name a f the f i i e or devi c:e to open 

m o d e F i I e a c c e s s m o d e s 

0 R e a d a c c e s s o n 1 y 

1 Nr i t e ac: c ess on 1 y 

2 R e a d / W r i t e a c e e s s 


R e t u r n V a 1 u. e? s s 
R e g i s t e r D 0» L s 

- 3 3 L (F i 1 e n a t f a u n d) 

- 3 5 L < N d h a n d 1 e s 1 e f t) 

.3 6 L (A c c e s s D e n i e d) 


Des er. r i pt i on s F_ 0 PEN posi t i ons the file poi nter at te begi nr"ii rig of the 

f :i 1 e. Y o u c a n c:: h a n g e t h e p o i n t e r s 1 o c a t i o n w i t h t h e 

F 8 E E K (4 2) f u. n e t i o n c a 11 „ 

U b e t h e h a n d 1 e r - eo t u r n e d b y F _ 0 F 4 E H t o r e f e r t o t h e f i 1 e f o r 

s u l:« s e q u e n t read, w r :i. t e , s e e k 9 a n «d c I o s e o p e r a t i o n s» Y o u 

c a n u s & F _ A T T R IB (4 3) t o g e t t h e f 11 e s a 11 r i b u t e a n d 

F _ D A TIM F. t o g e t o r s e t its d a t e a n d t i rn e s t a m p s» 
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Fli nct i d n 3E s Cl os b a F i 1 e 


C Interfaces 

LONS 

t c 1 o s e < h a n d I e > 

WORD handIe; 


P a r a rn e t e r B1 o c k s 


0 « F u n c 1 1 o n c o d e 3 E 1 
2 I handle ! 


P a !•' a m e t e r s s 

h andie F11e han d1e of fi1e t o b e ciosed 

R e t u r n V a 1 u e s s 
Register DO.L5 

- 3 7 L < I n v a 1 i d h a n d 1 e ) 

Descriptions The handle you specify in the parameter block on entry to 

F_CL0SE sh ouI d be one t h at was pr evi a us1y r eturned b y 
fIoPEN <3D)« 

A11 d i s k b u. f t e r f:f> a s s o c: i a t e d w i t h t h b f i 1 e a re 11 u s h e d a n d 
t h e f i 1 e ' s d i r e c t o r y e n t r y i u p d a t e d o n s u c c e s s f u 1 r e t u r n 
from this call. 








G e m D o s D o c u rn e n t ax t i o n 
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F u n c: t i o n 3 i ::: 's R e a d f r o m a F i 1 e 


C Interfaces 

LONG 

f ... r e a d < h a n d 1 e , 
WORD 
LONG 
BYTE 


cnt, pbuffer) 
hand I e;; 
cnt; 

•*pbuffer; 


P a r a m e t e r B1 o c k r, 


0 I Function code 3FI 

2 I handle i 

ij. ( j 

c n t •+* 

6 I I 

8 ! 

+ p buffer •+• 

A ! I 

P a r a m e t e r s s 

h a n d 1 ev F lie h a n d 1 e (r e t u r n e d f r o m F.0 P E N) o f f i 1 e t o b e r e a cl 

cnt Number of bytes to be read 

p b u. f : f ; e? r P o i n t s t o t h e b u f f e r i n t o w h i c: h t h e f i 1 e J s c o n t e n t s 

are to be read 

R e t u r n V ax 1 u e s 

R e g i. s t e? r D « L 

3 7 L (I n v a 1 i d h a n d 1 e) 









6 e m D o s D o c u rn e n t a 1 1 o n 
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F u. n c t i o n 4 0 s W r i t e t o a F i 1 0 


C Interfaces 


LONG 

f w r i 1 0 < h a n d 1 0 c n t,, p b u f i 0 r ) 

WORD handle; 

LONG cnt; 

BYTE *pbuff er; 


P ar a me t. 0 r B1 o e k s 


0 I f u n c t i a n c o d 0 4 0 I 

2 i handle ! 

4 » I 

cnt +• 

6> 1 i 

8 I 1 

-•*- pb utter + 

i I 


Parameters! 

handle File handle (returned from F.OPEN) 

c n t N u rn b 0 r o t b y 1 0 s t o b 0 w r i 11 0 n 

p b u t f 0 r F : * o i n t s t o t h eo b 1..1 f f 0 r t h a t c o n t a i n s 

t h e b y 1 0 s t o h 0 w r i 11 0 n 

R 0 1 u r n V a 1 u 0 s 
R 0 g i s 1 0 r D 0« L 

- 3 6 L (A c c 0 s s D 0 n i e d ) 

3 7 L < I n v a 1 i d h a n d 1 e) 
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Fun c t i on 41 s De I e t e a F i I e 


C Interfaces 


LONG 

f.deIe t e <n ame) 

BYTE *name? 


P a r a m e t e r B1 o c k s 


0 I f u n c t i o n c o d e 41 ! 

Z i I 

+ name + 

xl 1 1 

a T I 1 


Parameters: 


name 


P o i n t s t c::« a n u 1 1 -1 e r m i n a ted s i r :L n g t h a t s p ecifies t h e 
d r i v e * p a t h ,, a n d n a m e o f t h e d i. r e e t o r y e n t r y t o fa e d e 1 e t e d 

R e t u r n V a 1 u e s s 
Reg i st er DO • L r, 

~ 3 3 L (F i 1 e n o t t o u n d > 

-36L (Acc ess Deni ed ) 
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Function 42s Seek File Pointer 

C Interfaces 

LONG 

f s e e k < s o f t s , h a n d 1 e, s rn o d e ) 

LONG softs 5 

WORD handle; 

WORD sffiode; 


P a r a m e t e r B l o c k s 

0 I f u n c t i o n c o d e 4 2 I 

.1 i i 

S f 

•+• softs + 

4 ! ! 

6 I handle ! 

8 I smode I 

Parameters: 

s o f t s A s i g n e d v ax 1 u e , N, u s e d t o i n d i c: a t e b y t e o f f s e t 

negative values are useful in modes 1 and 2 below 
N m o v e s p o i n t e r t o w a r d e n d o f f lie, N t o w a r d 
to eg i n n i n g of f i 1 e 

h a n d 1 e F i 1 e h a n d 1 e (r e t u r n e d f r o m F _ 0 P f£ N) 

smode 1 nd i cates how the file poi nter i s to be moved 3 

0 Move pointer N faytes fr om t he faeginning of the fi1e 

1 Mo v e p oin ter N faytes f rom its current location 

2 M o v e p o i n t e r N b y t e s f r o m t h e e n d o f t lx e f i 1 e 

R e t u r n V a 1 u e s s 
R e g i s t e r D 0» L s 

f r om b eg i nn 1 n g of f i 1 e) 

- 3 7 L (I n v a 1 i d h a n d 1 e) 

- 3 2 L < I n v a 1 i d f u n c 1 1 o n) 
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Function 43s Get/Set Fi1e Attributes 

C Interfaces 

LONG 

f.a 11 r i b (p „ w r t, m o d) 

BYTE *p5 

WORD wrt,mod 5 


F* a r a i n e t e r B 1 o c: k s 

0 I f u n c 1 1 o n c o d e 4 3 ! 

•'.« k i 

jL 1 i 

4* P +• 

4 I I 

6 ! wrt \ 

8 ! mod I 


Parameterss 


P 

wrt 


mod 


P o i n t s t o a n u 11 -1 e r m i n a t e d s t r i n g t h a t c: o n t a i n s t h e 
d r i v e, p a t h , a n d f i 1 e n a rn e 

S p e c i f i e s t h e o p e r a t i o n t o b e p e r f o r rn e d s 
0 R e t u r n t h © f i 1 © s a 11 r 3. b u t © s i n D 0«!.... 

1 8 e? t th© t i 1 © ' s a11 r i hutes accordi ng to mod 

In dicat ©s file a11 rib ut©ss 
01 H Read--on 1 y 

0 2 H H i d d e? n f r o rn d 1 r e? c: t o r y s e? a r c h 
04H System, hidden from directory search 
0 8 H E n t r y c o n t a i n s t hi e v o 1 u m © 1 a b © 1 
1 0 H E n t r y i s a s u b d i r e c t o r y 

2 0 H A r c: h i v © < t i 1 © w r i 11 © n t o a n d c 1 o s e d) 


R ea t u r r *i V a 1 u & s 
R © g i s t © r D 0. L 

•••" 3 3 L < F i 1 © n o t f o u n d) 

- 3 /; l- L < P a t h n o t f o u n d) 
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F u n c t i o n 4 4 s I / 0 C o n t r o 1 


C Interfaces 

LONG 

f i oc11 (subf Lin ,, hndr v , cnt va 1 , buf p t r ) 

W 0 R D s u b f u n , h n d r v , cr. n t v a 1 ; 

LONG bu-fptr; 


P a r a m e t e r B1 o c k s 


0 ! f u. n c t i 0 n c: o d 0 4 4 1 
2 ! subfun \ 

4 ! handrv } 


6 ! cntval 



bufptr 

A ! ! 




Parameters! 


sub f Lin 


hndrv 


cntval 


bufptr 


F 10 C T L s Li b f Li n c t i o n c 0 d e v a 1 li e a s f o 11 o w s s 

1 8 u b s t i t i.i t e i n t e r r u p t v e c t o r 

0 8 e t d e v i c: e i n f o r rn a t i. o n 

1 Reserved 

2 Read from device contro 1 c:hanne 1 

3 W r i t e t a d e v ice c: o n t r a i c h a n n e I 

4 R e a d f r o m d r 1 v e c o n t r o 1 c h a n n e 1 

5 Wr i 1 0 to dr i v 0 control channe3. 

6 6 e t i n p u. t s t a t u s 

7 B 0 1 O Li t p Li t S t a t Li s 

8 Get media t yp 0 

Handle or drive code, subfunction dependent« See 
f a b I 0 4 7 h b 0 1 o w. 

Byte count or bit map of val Lies , subf unct i on dependent * 

Pointer to buff er or, for subfunction -1, th 0 address of 
ci 0 v i c 0 s into r r li p t v e c t o r« 


Return Val Lie 

Devi c:e ' s cur r en t i n t err upt vec t or for subf unc t i on ~1 

Bit rn a p o f d e v i c e i n f or m a t i on f or s t.i b f li c t i on 0 

N u m b 0 r o f b y 1 0 s t r a n s f 0 r r 0 d f o r s u b f u n c t i o n s 2 5 

Di sk f i 1 0 or char acter devi ce i nput statLis f or subf unct i on 6 

E> i s k f i i *e o r c h a r a c t e r d e v ice o u t p u t s t a t u s f o r s u b f u n c t i o n 

M 0 d i a t y p e f o r s u fo f u n c: t i o n 8 
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Descriptions On entry to F_I0CTL, offset 02 of the parameter block 

contains a subfunction code value that determines the 
operation to be performed., Other entry parameters vary 
a c c o r d i n g t o t h e s- u b f u n c t i o n y o u call- T a b 1 e 4 - 7 1 i s t s t h e 
F_10CTL subf uncti on c:ailing restri cti ons« Descri pti ons of 
t h e i n d i v i d u a 1 s u b f u n c t i o n s f o 11 o w t h e t a b 1 e« 


Tab1e 4-7« IOCTL Cal 1ing Restrictions 



Character 

Di sk 



Subfunction 

D e v i c e S t a n d a r d 

F i 1 e 

Dr i ve 

By t 

Number 

H a n d 1 e H a n die H a n d 1 e 

Number 


Count/Buff er 


X 

X X X 

X 
X 
X 
X 


Subfunction -Is Specify a character device handle at offset 04, 0 at offset 

06„ and the address of the device's interrupt hand1er at 
offset 08 of the F_I0CTL parameter block- Subfunction -1 
returns the current interrupt vector for the device whose 
hand 1 e y ou spec i f y. Not e t hi at on 1 y a c har ac t er devic e 
h a r i d 1 e c a n b e s p e c i f i e d f o r t h i s s u b f u n c t i a n » 









6 0 m 0 o s D o c u m e n t a t i o n 
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Sli bf unc: t i on 0 s 8pec i f y a d i sk f i 1 e or ch ar ac t er devi ce h and 1 e at off set 04 

of the F. I0CTL parameter block. Subfunction 0 returns the 
bit map of device information shown below or an error 
number <-35L« "-37L ) in register DO.L. 

If bit 7 « Os 

Bits Mean!ng 

D r i v e n u m b e r 
Reserved 
0 = Disk file 
Reserved 

1 = D e v i c: e e a n p r o c e s s 
c o n t r o 1 s t r i n g s 
Reserved 


If bi t 7 = 1 s 

Bi ts Meani ng 

1 = C 0 N s i n p u t (s t d i n > 

1 « C 0 N s o u t p u t <s t d o u t) 

1 « NULs 
1 « CLKs 
Reserved 

1 - Charact er device 
Reserved 

1 « Device can process 
cont r o 1 st rin gs 
Reserved 

Su h func tion 2s Sp eoi f y th e han d1e of a c har ac t er devic e at offset 4 9 t he 

number of bytes to be? read at offset 6, and the address of 

t h e b uffer in t o whic h this sub function is t o r ead 
c h ar ac t er s f r om t h e d ev i c e s c: on t r o 1 c h an n e 1 at of f set 8 of 

the F 1OCTL parameter b1ock« 

Subfunction 2 returns the number of bytes read or an error 
n u m b e r i n r e g i s t e r D 0. L. 

8 u b f u n c t i o n 3 8 p e c i f y t h e h a n d 1 e o f a c h a r a c t e r d e v i c e a t o f f s e t 4 , o f 

t h e n u m b e r o f b y t e s t o b e w r i 11 e n t o t h e d e v i c e s c o n t r o 1 

channe1 at offset 6, and the address of the buffer from 

which the bytes are to written at offset 8 of the F.I0CTL 

p a r a m e t e r b 1 o c k* 

S u b f u n c t i o n 3 r e t u r n s t h e n u m b e r o i ; b y t e s w r i 11 e n t o t h e 
device control channel or an error number in register DO.L. 


0 

1 

4—6 

7 

8-D 

E 

F 


0—5 

6 

7 

8-D 

I:::. 

F 
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8 u b f u n c t :i. o n 4 8 p e c i f y t h e n u rn b e r o f t h e* d r i v 0 a t o ff s 0 1 4 «$ t h e? n u m b 0 r a f 

by1 0 s to he r 0 ad from th 0 dr i v 0 s cantro 1 channel at of f set 

6,; and the address of a buffer at offset 8 of the F.IOCTL 

p a r a m 0 1 0 r b 1 o ck« 

The drive number can be 0 for the default drive, 1 for 

d riv 0 A, and so on up t o th 0 numb er of drives sup p ort ed b y 

y a u. r p a r t i c u 1 a r s y s 1 0 m. 

Sub-function 4 returns the number of bytes read from the 

d r i ve s c: on t r o 1 c h ann 0 1 or an 0 r r or numb 0 r i n regi ster D0. L 

8 u b f u n c t i o n 5 S p e c i f y t hi 0 n u m b e r o f the d r i v e a t o f f s 0 1 4 , t h 0 n u m b e r o f 

!;:• y 1 0 s t o wr i 11 0 n t o t h e d r i v 0 J s c: on t r a 3. c: h an n e 1 at off set 

6, and the buffer from which the bytes are to be written at 
o f f s 0 1 8 o f t h 0 F _ 10 C T L p a r a m 0 1 0 r b 1 o c k. 

8 u b f u r* c t i o n 5 r e t u r n s t h 0 ri u m b e r o f b y t e s w r i 11 e n t o t h e 

dr i v 0 s cont r o 1 ehannel or an er r or numb 0 r i n r 0 g i s1 0 r 
DO n L « 

8 u b f u n c: t i o n 6 8 p e c i f y the h a n d 1 e o f a d i s k f : i 1 e o r d e v i c e w h o s e i n p u t 

status you want returned at offset 4 of the F IOCTL 

p a r a m e t e r to 1 o c k „ I f t h e h a n d 1 e y o u s p e c i f y i s a d i s k f i 1 e, 

s u b f u n c t i o n 6 r 0 1 u r n s 2 0 r o i n D 0« L w h 0 n the f i X e p a i n 1 0 r i s 

at E0F „ or a non- 2 ero va 1 ue» If the f i 1 e poi nter i s 

r 0 posi t i on 0 d af 1 0 r r 0 achi i ng E0F , t h i s sub f unc t i on r 0 1 ur ns a 
n o n - 2 e r o v a 1 u e a g a i n 

I f t he hand I e you spec i f y 1 s f or a devi ce, subf unc t i on 6 
r 0 t u r n s a n c:« n - z e r o v a 1 u e 1 n D 0. L t o i n d i c a 1 0 a re a d y s t a 1 0 ,, 

o r z 0 r o t o i n d i c a 1 0 t h a t t h e d e v 1 c e? i s n o t r 0 a c:l y» 

8 u b f u n c t i o n 7 8 p 0 c i f y t h 0 h a n d 1 e o f a d 3. s k f i 1 e a r d e v i c 0 w h o s 0 o u t p u t 

s t a t u s y o u w a n t r e t u r n e d a t o f f s e t 4 o f t h e F _ 10 C 7 L 

param 0 1 0 r b 1 ock « If the hand 1 e you speci fy i s f or a disk 
f i 1 e , s u b f u n c t i o ri 7 r e t u r n s z e r o i n D 0» L w h e n the file 
pointer is at EOF, or a non-zero value« If the pointer is 
r epo©i t i oned af t er r each 3. nq E0F , t h i s subf unc t i on r et ur ns 
n o n z 0 r o a g a i n . 

1 f t h e h a n die y o u s p e c i f y i s f o r a device, s u b f u n c t i o n 7 

r 0 1 u r n s a n o n - z 0 r o v a 3. u 0 t o i n d i c a 1 0 a re a d y *s t a 1 0 , o r a 

2 e r o v a 1 u e t o i n d i c: a 1 0 t h a t t h e d e v i c: e is n o t r e a d y f o r 

output« 

S u t:* f u n c t i o n 6 8 p e c i f : y t h e n u m b e r o f t h e d r i v e w h o s e m e d i a t y p e y o u 

returned at offset 4 of the F.IOCTL parameter block. If 

t h e d r i v e n u m b r y o u s> p e c i f y i s v a 1 i d , t h i s s u t;:* f u r *i c t i o n 
returns zero to indicate that the drive contains removable 

m edia or a n on ~z 0 r o va1ue t o in die a1 0 th at th 0 d riv 0 

c o n t a i n s f i x 0 d m 0 d i a a 

I h e d r i v e ri u m b 0 r y o u s p e c i f y m a y b 0 0 *i ; o r t h i 0 d e f a u 11 

dr i ve , 1 f or d r :i v 0 A , and so on up t o t h 0 numb 0 r of dr 3 . v 0 s 

s u p p o r 1 0 d b y y o u r p a r t i c u a 1 r s y s t & m» 
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Function 45s Duplicate a File Handle 

C Interfaces 

LONG 

f... d u p (s t d h n d > 

WORD stdhnd; 


P a r a m e t. e r B1 o c k s 


0 ! 

-"i I 
Jt. I 

Parameters! 

s t d h n cl S t a n d a r d t i 1 e h a n d 1 e 

Ret u r n V a I u. e? s s 
R e q i s t e r D 0L s 

3 5 L (N o h a n d 1 e s 1 e f t) 

3 7 L„ (I n v a 1 i d h a n die) 

Descr i pt i on s F.DUF 1 accepts a standard t i 1 e hand 1 e as i nput and return b a 

n o n s t a n d a r d h a n d 1 e t h a t r e t e r s t o t h e s a m e f i le or d e v ice 
a t t h e s a m e p cj s i t i o n « 

11 y ou u b e F_SE E l< (42) t o e h an g e t h e loc at i on o f t h e 
p o i n t e r f o r e i t h e r l "i a n d 1 e, t h e p o i n t e r o f i t s d u p I i c a t e i s 
aiso moved„ 

See Table? 4--2 for the GEM DOS standard handle values« 


f u n c: t i o n c o d e 4 5 
stdhnd i 
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F u n c t i o n 4 6 s F a r c 0 F i 1 e H a n d 1 0 


C Interfaces 

LONG 

f.f 0 r c 0 < s t d h n d n 0 t h n d) 

W O R D s t d h n d * n s t h n d; 


P a r a m e 1 0 r B1 0 c k s 


0 1 

» 

4 1 


Parameterss 

s t d h n d 81 a n d a r d f i 1 0 h a n d 1 0 

n s t hi n d N o n - s t a n d a r d f i 1 0 h a n d i 0 

R 0 1 u r n V a i u 0 s s 
R 0 g i s t 0 r D 0« L s 

-37 L <I n valid h a n d1 0 ) 


De 0 c:r i pt i 0 n s F F0F<CE f 0 rces th 0 0 1andard d 0 vi c 0 handI 0 0 peci f i 0 d at 

offset 02 of the parameter block to point to the same file 

o r device a s t h 0 n 0 n s t andar d han d1 0 sp 0 cifi 0 d at 0 ff s 01 

04. 

I f the f i 1 0 whose hand I 0 you spec i f y i n st dhnd i s open ,, 

F.F 0 R C E c 1 o s e s h 0 f 0 r e r 0 1 u r n i n g» I f y 0 u u s 0 F _ S E E K (4 2) t o 

c h a n g 0 t h e 1 0 c a t i o n 0 f t h 0 p 0 i n 1 0 r f o r e? i t h e r h a n d i n t h 0 

p o i n t e r o f i t s d u p 1 i c a 1 0 i s a 1 s 0 m c:« v 0 d« 

8 0 0 T a b 1 0 4 - 2 f 0 r t h e G E M D 0 8 s t a n d a r d h a n d 1 e v a 1 u 0 s. 


function code 46i 
stdhnd I 

nsthnd I 
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F u n c t i a n 4 E s B e a r e h f a r F i r s t 0 c c u r r e n e e a t F i 1 e s p e c 


C Intertaces 


LONG 

•f.s f i r s t < p s p e c , a t1 r) 

BYTE *pspec3 

WORD attr; 


P a r a m e t e r 8I o c k s 




0 i 

•f u n c t i o n c o d e 

4ES 

E 

--- {.. --- 

" --4* 

« 

sL 1 

4 i 

p sp 0C 

t 

j 

i 


---f- 

..-4- 

6 1 

attr 

i 

» 

H. 

.....-4.. 

•• ... 4* 


Parameterss 


pspec 


attr 


P o i n t s t o a n u 11 — t e r m i n a t e d s t r i n q t h a t s p e c i f i e s t h e d r i v e , 
p a t h a n d n a m e o f t h e f i 1 e t o s e a. r c h f o r ? o n 1 y the f i I e 
name portion of pspec may contain * or ? wildcards 

S p e c i f i &: s t h e h*> e a r c h a 11 r i b u t e s s 


00H 

F i 1 e 

i 

s n o r m a l r i 1 e e n t r y 

01H 

F i. 1 e 

i 

s read-onIy 

02H 

Fi ie 

i 

s h i d c:l e n f r o rn d i r e c t o r 

04H 

F i 1 e 

i 

s system file 

OSH 

Entry 


i s a v o I u m e j. a b e I 

10H 

Entry 

is a subdirectory 

20H 

Fi Ie ' 

s 

a r c h i v e b it is s e t 


e t u r n v a 1 u e s 
Re^g i st er D0« 

3 3 L (F i l e n o t f o u n d) 

4 9 L. (N o m o r e f i 1 e s) 
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ST 


Descript ion s 


F.S FIR S T s e a r c h e s f o r 

m a t c h e s p s p e c a c c o r d i n g 


F.S FIR 8 T u. s 0 s t h e v a j. u 0 

* If attr is 00H, 
d 1 r 0 c t o r y 0 n t r i 0 s« 
f o r v o 1 u rn e 1 a b 0 1 s 
system fi1es« 


t h 0 fir st d1r 0 ctory 0 n t ry t hat 

t o t h e v a i u 0 o f a 11 r „ 

o f a 11 r i n t h 0 f o 11 o w i n q rn a n n 0 r s 

t h 0 s 0 a r c h 1 s r 0 s t r i c 1 0 d t o n o r rn a 1 
F..... S FIR S T d o 0 s n o t r 0 1 u r n 0 n t r i 0 s 
s u b d i r 0 c t o r i 0 s ? I"! i d d 0 n f i 1 0 s , o r 


* I f a 11 r i s s 0 1 t o t h 0 h i d d 0 n (0 2 H) o r s y s 1 0 rn < 0 4 H) f i 1 0 
v a 1 u 0 s , t h e y a r 0 1 n c 1 u d 0 d w i t h t h 0 n o r m a 1 0 n t r i 0 s x n 

t h 0 s 0 a r c h s 0 1« V o u c a n u s 0 F.S F IR S T t o s 0 a r c h f o r a 11 

directory entries except volume labels by setting attr 
f o r h i d d 0 n , s y stem, a n d d i r 0 c t o r y, 


* 1 f a 11 r i s s e t t o t h 0 v o i u m e label v a 1 u e £0 8 H .) , 

F 8 F 1 R 8 T r 0 s t r i c t s 1 1 s s 0 a r c h t o v o 1 u m 0 1 a b 0 1 s ,, 

If FSFIRST finds a directory entry that matches pspec and 

a11 r , i t f or mat s t h 0 DTA as shown i n Tah I 0 4-8 „ F.G E .TDTA 

< 2F} returns the current 3. ocat i on of th 0 DTA buf f er « 


T a b I 0 4 - 8. D T A C o n 1 0 n t s f r o m F _ 8 FIR 8 T C a 11 

DTA Offset Contents 

0 - 20 Reserved for 08 use 

21 F i 1 e ■' s at t r i b ut es 

22 . 23 FiI 0 's time stamp 

24 - 25 File‘s da1 0 st amp 

26 — 2 9 L o n g w o r d o f f i 1 e s s i z & 

30 - 43 Flie s na m 0 and ex1 0 nsion 
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F u. n c t i o n 4 F s 8 0 a r c h f o r 14 0 x t O c c u r r 0 n c 0 o f F i 1 0 s p 0 c 

C Interfaces 

LONG 
f snewt () 


F‘ a r a m 0 t 0 r B1 o c k s 

0 ! f u. n c t i o n c o d 0 4 F I 

R 0 1 u r n V a 1 u 0 s s 
R 0 g i s 1 0 r D 0« L s 

4 9 L (N o m o r 0 f i 1 0 s) 


0 0 s c r i p 1 1 o n F.8 N E X T u s 0 s t h 0 p a r a rn 0 1 0 r s s p« 0 c: i f i 0 d i n a p r 0 v i 0 u. s 

F _ 8 FIR S T (4 E) o r F 8 N E X1 c: a 11 t o 1 o c a 1 0 t h 0 n 0 m t rn a t c h 1 n g 

d i r 0 c t o r y 0 n t r y» 0 f f 0 01 s 0 t o 2 0 o t t f” i 0 DIA m u 01 r 0 rn a i n 

u n t o u c h 0 d + r o m t h 0 p r 0 v i c:« u. s S F IE 8 T o r 8 N E X T c a 11 « 

11 F N E X T 1 o c a 1 0 s a rn a t c I t 1 n g 0 n t r y , 1 1 u p d a 1 0 s t h 0 c o n 1 0 n t s 

of the DTA buffer initialized by the previous F SFIfxST or 
F N E X T c a 11 a s s h o w n i n T a b 1 0 4 - 8 a b o v &« 










G e m D o s D q c: u m e n t a t i q n 
S 0 r i a 1 N u. m b e r 006738 


F u n c t i o n 5 6 s R e n a m e a F i 1 e 

C Interfaces 

LONG 

f.r 0 n a m e \ r e s * p i , p 2) 

WORD res? 

BYTE *p 1", 

BYTE *p2? 


P a r a m e t e r B i q c k - 

0 » f u n c t i o n c a d e 5 6 I 

2 1 Must be O ! 

4 ! ! 

+ p 1 4- 

6 1 I 

8 ! 

4 - P 2 4- 

A 5 

Parameters! 


p 1 

Points 
drive, 

t o a 
path 

n u 11 
, and 

-1 & r rn i n a t e d s t r i n g t h a t 
name of the file to be 

contains the 
renamed 

P 2 

Points 

t o a 

nul 1 ■ 

-1 e r rn i n a t e d s t r i n q t j" i a t 

contains the 


p a t h a n d n e w n a m e f o r t h e f i I e s p e c 3. f i e d i n p 1 


R e t u r n V a 1 u e s ;; 
R e g i s t e r D 0« L s 

- 3 4 L. (P a t h n o t f o u n d) 

.3 6 L < A c c: 0 s s d e n :i e d ) 

Descriptions The word at offset 2 in the parameter block is reserved for 

system use and rnust be z ero« T he file name spec i f i e<d i n 

t h e p 2 st r i n g mu s t n o t ex i s t« I f y ou s p e c i f y a d r i v e i n 
t h e p 2 st rin g, it must b e t h e same drive specified in t h e 
s t r i n g p o i n ted t o b y p 1 

Y o u c: a n s f:) e c i f y a d i *f : f e r e n t d i r e c t o r y p a t h i n t h & p 2 s t r i n g 
o t h a t t h e o p e r a t i a n m o v e s t h e f i. 1 e t o a n o t h e r 
s u b d i r e c t c:« r y o n t h e s a m e d r i v e« 

F.! :: < N A M E r e t u r n s — 3 6 L- i n E> O i f t h e r e a d / o n 1 y a 11 r i fc) u t e o f 

the file to be renamed is set. 
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F u n c: t i. o n 5 7 s G e t / 8 e t F i 1 e D a t e a n d T i rn e 81 a m p s 

C Interfaces 

VO ID 

•f d a t i m e < b u f h , s e t.) 

BYTE *buff; 

WORD h ? 

WORD set; 


P a r a m e t e r B1 o c k : 



H— 

--— 4.—. 

.. 4* 

0 

! 

t unc 1 1 on c od e 

57 1 


-i — 

-+- 

i 

L\. 

j 

i 

but + 

i 

4- 

*T 


—.-4_ 

+ 

h 

) 

i 

h 

i 

j 


H— 

—..1-.--- 

.I- 

8 

« 

t 

set 

i 

i 


4—- 

----..— 

•.{•■ 


Parameters: 


b u f t P o i n t s t o a b u f f e r t h a t c: o n t a .i n s t h e t i m e i n t h e firs t 

w o r d a n d t h e d a t e i n t h e s e e o n d w o r d 


h Contai ns the f i 1 e hand 1 e retu.rned f rorn F....0PEN 

s e t A f 1 a g t h a t s p e c: i -fie s t h e o p e r a 1 1 o n t o b e p e r f o r m e d s 


0 S e t d a t e a n d i i m e 

.1. R e t u r n d a t e a n d t i m e t o b u f t 


Descriptions 


T h e t o r rn a t o t t h e d a t e a n d t i rn e c o n t a i n e d i n t h e b u i f e r 
p o i n t e d t o b y b u f t 3. s a s f o 11 o w s;; 


Time (word 0)s 
Bits 00 04 

Bits 05 10 

Bits 11 - 15 

Date (word l)s 
Bits 00 - 04 
Bits 05 08 

Bits 09 — 15 
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4.6 DRIVE AMD DIRECTORY MANAGEMENT FUNCTIONS 

T a b 1 0 4 ~ 9 1 i s t s t hi e n u rn b 0 r , rn n 0 m 0 n i c , a n d n a rn 0 o t t h 0 8 E M D 0 S d r i v 0 a n d 

d i r 0 c 1 0 r y m a n a g 0 m 0 n t f u n c t i o n s „ 


f a b 1 0 4 - 9« D r i v 0 a n d D i r 0 c 1 0 r y M a n a g 0 m 0 n t F u n c t i o n © 


Hex 

Mnemonic 

OE 

D.SETDRV 

19 

D_GETDRV 

36 

D.FREE 

39 

D ...CREATE 

3 A 

D DELETE 

3B 

D_SETPATH 

47 

D GETPATH 
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F u n t i o n O £ s S 0 1 D 0 f a u 11 D r i v 0 

C Interfaces 

LONG 

cl. s 0 1 d r v (n 0 w d r v) 

WORD newdrv; 


P a r a m 0 t 0 r 81 o c I--.: s 

0 I 
2 i 

-I- 

P a r a rn 0 t 0 r s s 

newcirv Specifies the number for the current drives 
0 Drive A 

1 Drive B 

3 Drive C 


15 Drive F* 

R e t u r n V a 1 u 0 s s 
R 0 g i s t 0 r D 0« L s 

B i t 0 
Bit 1 
Bit 2 


Bit 15 

D 0 s c r i p t i o n s D.S E! T D R V cl 0 s i g n a 1 0 s t h 0 d r i v 0 w h o s 0 n u n i b 0 r i s s p 0 c: i f i 0 cl a t 

0 f f s e t 0 4 i n t hi e p a r a m 0 1 0 r b 1 o c k a s t hi 0 c u r r 0 n t d r i v 0 a n ci 

r 0 1 u r n s a b :t t m a p) o f t h 0 s y 1 0 m d r - i v 0 s i n D 0« L« 


= H 



^ p 


f u n c: t i o n c o d 0 0 E ! 
newdrv I 
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F u n c t i c:» n 19 s G 0 1 L> 0 f a u X t D r 1 v 0 


C Interfaces 


LONG 

d.getdrv <) 


P a r a m 0 1 0 r B 1 o c k ;i 


0 I t un c t i on c od 0 191 


Descriptions 


R 0 1 u r n V a 1 u e 
R 0 g i s 1 0 r D 0« L 

D G E T D R V r 0 1 u r n s t h 0 n u rn b 0 r o f t h 0 c u r r 0 n t d r i v 0 i n D C> * L 
where: 0 = A* 1 = B, 2 = C, up to 15 « p 
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Function 36s Get Drive Free Space 


C Interfaces 


LONG 

d f r e e < p b u f f 0 r 9 d r ) 
B Y T E * p b u t f 0 r 
WORD dr; 

■I 

P a r a m 0 1 e r B i o c k s 

4 . 

0 1 
4 . 

* .i » 

1 

4 I 
6 I 

H- 


f u n c 1 1 o n c o d 0 3 6 i 

» 

pbuffer f 

! 

dr i 


Parameters^ 

p b u f f 0 r P o i n t s t o t h i e b u f ter i n t 0 w h i c hi D F R E E r 0 1 u r n s 

d r i v e i n f o r m a 1 1 o n 

dr Specifies the drive code wheres 

0 = C u r r e n t D r i v e 9 .t «= D r i v e A « 2 ~ D r 1 v 0 B , e t c » 

R 0 1 u r n V a 1 u e s s 
R 0 g i s t e r D 0« L s 

- 4 6 L.. (I n v a 1 i d d r i v e s p e c i f i & d ) 

D 0 s c r i p t :i. c::« n s T h 0 f o r m a t o f t h 0 b u *f f e r p o i n t e c:l t o b y p b u f f e r a n 

succ essfu 1 retur n from D_FREE is sh own in Figur 0 4-4« 


0 i Number of Free Bytes on Drive I 
4 1 N u m b 0 r o f A v a i 1 able C1 u s t e r ** s I 


8 1 Bytes per Sector I 

C ! Numb 0 r of 8ect or s p 0 r C1uster I 


F i g ur e 4 •- 4 = D F R EE 1 n f or m at i on Ret ur n Bn ffer 
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F u n c 1 1 o n 3 9 s C r e a t e a 8 u b d i r e c t o r y 


C Interfaces 


LONG 

d c r e a t. e < p a t h) 

BYTE ft-path n 


P a r a rn e t e r B1 o c k s 


0 1 f unc: 1 1 on code 39 I 

i « 

J I 

+ path + 

4 I ! 


Parameters! 

path Poi nt s t o a nu. 11 -termi nat ed str :i. ng t hat c ont ai ns t he 

d r i v e a n d p a t h n a m e o t t h e s u b d i r e c t o r y t o b e c r e a t e «d 

R e t u i”' n V a i u e s s 

R e g i s t e r D 0 » L js 

- 3 4 L (P a t h n o t t o u n d) 

.3 6 L ( A c: c e s s d e n i e d) 

D e s c r :i. p t i o n s D.C R E A T E::* d o e s n o t c: h a n g e t hi e d i r e c: t o r y p a t h :i. t a n y e I e rri e n t 

o t t h e p a t h n a m e c o n t a :t n e d i n t h e p a t h s t r x n g d o e s n o t 

exist. If DO.L contains 0 on return from D CREATE 9 the new 

s u b d i r e c t o r y x s c r e a t e d a t t h e e n <: J o f t h e p a t h n a m e« 
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F u n c t i o n 3 A s D e 1 e t e a S u b d i r ec t o r y 


C Interfaces 

d 


LONG 

d e 1 e t e v p a t h) 

BYTE *path r» 


P a r a m e t e r BI o c k s 

0 I function code 3A! 

si i 

I » 

•+■ path 

4 ! S 

Parameters! 

pathi Poi nts to a nu 11 -1ermi nated str i ng that c:onta:i. ns the 

dr i. ve and pathiname of the sutod i rectory to toe deleted 

R e t u r n V a I u e s s 
R e g i s t e r D 0«L s 

- 3 4 L (P a t h n o t f o u n d) 

.3 6 L < A c: c e s s d e n i e cl) 

-65L (Iniern a1 err or) 

Descriptions It the subdirectory to toe deleted is not empty, D_DELETE 

r e t u r n s - 3 6 L (A c c e s s d e n i e cl) « E>.D IE L E T E a 1 s o r e t u r n s a n 

e r r o r c o d e i t y o u a 11: e rn p t t o d e 1 e t e t h e c u r r e n t o r r o a t 

di rector i 
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F Li n c t i o n 3 B i; 8 e t C u r r e n t D i r e c t o r y 


C Interfaces 

LONG 

d..s 0 1 p a t h (p a fc h) 


BYTE 

*path; 


1 



a r a m 010 r B1 cd c k s 




+. ... 

- 


0 i t uncti0n code 

3 B i 


i 

4... ! 

■+• path 

4 ; 

1 

4 * 

| 



. h 


Parameters? 

p a t h P o i n t s t o a n u i I -1 e r m :i. n a t e d s t r i n q t h a t c o n t a i n s t h e 

d r i v e a n d p a t h n a m e o f t h e d i r e c t o r y t. o b e rn a d e c u. r r e n t 


R e t u r n V a 1 u e s s 
R e q i s t e r D 0« L s 

3 4}.... < P a t i"i n o t t o u n d ) 


11 0 0 = L c CD n t a i n s 0 o n r e t u r n f r o rn D.S E T P A T1-1, t hi e c u r r e n t 

d :i r e c t o r y :i s s e t t a c a r r 0 s p o n v\* i t h t h 0 p a t h s t r i n g« 


Descr1ption 
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F u n c t i o n 4 7 s G e t C u r r e n t D i r e c: t o r y 

C interfaces 

LONG 

d.... g e t p a t h < p a t h b u t , d r i v e) 

BYT E *pathbut 5 

WORD drives 


P a 1**“ a m e t e r B 1 0 e k s 


0 I f u.nc:t i on code 47 I 

*• 1 1 « 

•C*_ I ! 

+ pathbut + 

4 I i 

6 i drive \ 


Par arneterss 

pathbat Points to a 64-byte butter into which 0.6ETPATH writes 

11"! e c o m p 1 e t e p a t h n a m e o t t h e c u r r e n t d 1 r e c t o r y 

drive Con t ain s t he d r i ve code where 5 

0 = c u r r e n t d r i v e , 1 :r ~ d r i v e A, 2 = d r 3 . v e B , e t c« 


- 4 6 L (I n v a 1 i d d r 3 . v e) 


R e t u r n V a 1 u e s s 
R e g 3. s t e r D 0 « L a 


Oescriptions 


D.G E T P A T H w r i t e s t h e p a t h r "i a rn e < b e g i n n i n g T r o m t h e r o o t) o i 

t h e c u r r e n t d 3 . r e c t o r y t o r t h e d r i v e s p e c i t i e d i n t h e 

p a r a m e t e r b i c::> c k i n t o t h e n u 11 -1 e r m 1 n a t e d t:« u f : t e r p o i n t e d t o 

b y p a t h b u t« D.G E T P A T H d o e s n o t 1 n c 1 u d e t h e cl r i v e 1 e 11 e r 3 . n 

t in e p a t h n a rn e n o r cl o e s i t b e g i n t h e p a t h n a rn e w i 11*! a 

backslash <\)„ 
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4.7 PROGRAM CONTROL FUNCTIONS 

Table 4-~i0 lists the number, mnemonic„ and name ot the GEM DOS system calls 
d e s c r :i. b e d :i n 11"! i s s e c 1 1 a n « 


i ' a b J. e 4 10« S y s t e rn a n d P r o g r a m C o n t r o 1 F u n c: t i o n C a 11 s 

Hex Mnemonic 


00 P T'ERMO 

25 slBETVEC 

30 SEVERSION 

31 p tERMREB 

35 sIgETVEC 

4B P.EXEC 

4C P1.TERM 


F u n c t i o n 0 0 s F* r o g r a m ! * e r m i n a t e 


C Interfaces 


VO ID 

p termO () 


P a r a m e t e r B1 o c k s 


! f u n c 1 1 o n c o d e 0 0 1 

P.T E R M 0 t e r m i n a t e s t h e c a 11 x n g p r o c e s s a n d r e t u r n s t a 

p a r e n t p r o c e s s w i 11"! a r e t u r n c o d e? c::« t C>« 


Description 


the 
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F u n c t i o n 2 5 s 8 e t E x c e p 1 1 C3 n V e c t o r 


C Interfaces 

LONG 

s.s e t v e c: (v e c n u m, a d d r e s s) 

WORD vecnum; 

L 0 N B a d d r e s s $ 


F‘ a r a m e t e r B1 o c k s 

! t u n c t i o n c o d e 2 5 I 

I vecnum I 

! 1 

address •+• 

$ i 

I l 

Parameters: 

v e c n u m V e c: t o r n u rn b e r 

a d d r e s s N e w a d d r e s s t o r v e c t o r n u m b e r 

R e t u r n V a I u e s s 
R e g i s t e r D 0« L s 


Descriptionu 8 8ETVEC associates a vector number with the specitied 

address,, 


0 


4 


o 
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OJ 


F u n c 1 1 o n 3 0 s 0 e t V e r s i o n N u rn b e r 


C Interfaces 


WORD 

s version () 


P a r a rn e t e r B1 a c k s 


O i f u n c t i o n c o d e 3 0 ! 


R e t u r n V a 1 u e s s 
R e g i s t e r D 0. W s 


Descriptions The lower byte of the word returned in DO contains the 

m a j o r v e r s i o n n u m b e r $ t h e u p p e r b y t e c o n t a i n s t h e m i n o r 

v e r s i o n n u m b e r « 0001 - v e r s i o n 1 „ 0 0» 


F unc t i on 31 n Ter rni nat e and 81ay Resi dent 

C Interfaces 

VOID 

p_termres i n ....bytes,rc > 

LONG n.bytes 

WORD rc s 


P a r a m e t e r B1 o c k s 

0 ! f u n c: t i o n c o d e 31 i 

4- n bytes 4- 

4 » . ! 

6 I rc I 


Parameterss 

n b y t e s IT e m o r y s :i. z e i n b y t e s 

rc Exit code 

D e s c r i p t i o n s P.T EL’ R IT El* E S a 11 o w s t h e c a 11 i n g p r o c: e s s t o t e r m i n a t e t h e 

c u r r e n 11 y r u. n n 3. n g p r o c e s s a n d 1 e a v e t h e a m o u n t o f rn e m o r y 

s p e c i f i e d i n n b y t & s \ o f f s e t 0 2) r e s i d e n t» 

T h e r o f i e 1 d a t o f f s e t 0 6 o f t h e P _ T E R IT FI IE S p a r a m e t e r b 1 o c k 

c o n t a i n s a n e x i i: c o d e t h a t i s r e t u r n e d t o t h e p a r e n t 

p r o c e s :H> i n r e g i s t e r D 0« 

Note that your use of F*_TERMRES might make your program 
d :t f f i c u 11 t o p o r t t o T u t u r e v e r s i o n s o f t h i s o p e r a t i n g 
system. 
















Bern 

Ser 

D o s D o c u rn e n t a t 
i a 1 N u. m b e r 0 0 

: i on 
i> 7 36 



Function 35 

s Get Exc eption Vect or 


Interfaces 

LONG 

s.s e t v e c: < v e c n u m ) 

WORD vecnums 




ar am e ter 181 < 

DC k s 





•f . 

0 1 

4 i 

.C~ i 

4* — 

t u. n c t :i o n c o d e 

vecnum 

nr i 
•«*%J i 

i 

.—i- 


arametersi 





vecnum 

V e c t o r n u rn b e r 



R b t u r r 'i V a 1 u e s s 

E e g i s t e r D 0« L s 

escr i pt :L on s 

8 _BETVEC return 
v e c t o r n u m fo e r » 

s t. h e a d d r e s s 

associated 

w 3. t h t h e specif i ed 
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Fu n c 1 1 o n 4B g L o ad o r E m ec: u t e a Pr ocess 


C Interfaces 


LONG 

p e >t e c (1 o a d , p c s p 0 c r, p c m d 1 n , p e n v b t r * 


WORD 

1 oad s 

BYTE 

*pcspec 5 

BYTE 

*pcdln 5 

BYTE 

*penvstr; 


P a r a m e t e r B 1 o c k s 


0 ! f u n c t i o n c o d e 
^ I Ioad 


.4- 

4B i 

..h 


j 

4* - 
8 j 
4- 

Pi I 

4* •• 


pc: spec 


pc dl n 


C I I 

4- penvstr •+• 

E I I 


Parameters! 


1 oad 


pcspec 

p c d 1 n 

penvstr 


I n ci i c a t e s t h e t y p e o f 1 o a d t u n c t i o n t o b e p © r f o r m e d s 

0 L o a d a n d e k e c u t e p r o g r a m 

3 L oad ove rlay, do n ot e k ec ut e 

Polnts to a nul1-terminated string that specities 

t h e d r i v e, p a t h , a n cl n a rn e o f t h e f i 1 e t o b e 1 o a d e d 

P o :L n t s t o a c o m m a n d t a :i. 1 t h a t i n c 1 u <i e s r © d i r e c t i o n 
information 

F 4 o i n t s t o t h e r S C11 s t r i n g s t h a t d e s c r i b e t h e 
c n f i g u r a t i o n o t t h e p r o c e s s s e n v 3. r o n © n t 


o n 1 o a d / e k e c u t e (1 o a c i ~~ 0 > 

Base page address 
o n 1 o a d o v e r 1 a y (1 o a d =* 3) 

•• 3 3 L (F i 1 e n o t f o u n d) 

.3 9 L (I n s u. f f i c i e n t m e m o r y) 

.6 6 L < I n v a 1 :i d p r o g r a rn 1 o a cl f o r m a t) 


R e t u r n V a 1 u © s 
Register DO.L 
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D o s c r i p t i o n n T h e a d d r e s s c o n t a i n e d i n t h e p c d 1 n fie i d i s p 1 a c e d a t 

o f f set 80 H i n t h e b ase page of t h e p r o q r a rri b e i n g 1 oa d ed« 

! h e p r o c e s s e n v i r o n m e n t s t r i n g s p o i n t e d t o b y t h e p e n v s t r 
field at offset OC in the P_EXEC parameter block are 
f o r rn a 11 e d a s a s e r i e s o f n u 11 -1 e r m 1 n a t e d s t r i n g s« T h e s e 

e n v i r o n rn e n t s t r i n g s a r e t e r m i n a t e c:l b y a n u 11 w c::* r d» I h e 

address c:ontai ned i n the penvstr f i el d i s cop i ed i nto the 

p en v f i el d at of f set 2C of the base page« 

The child process exit code returned by F^TERMRES in DO«L 

c a n b e s p e e i f i e d a t o f f s e t 0 2 i n t h e p a r a rn e t e r 1 o c k u s e d 

t o i n v o k e T e r m i n a t e P r o c e s s (4 C H ) „ 

S e e 8 e c t i o n f o r a d e ei- c: r i p t i o n o f t h e h a s e p a g e f o r rn a t« 

Fun ction 4Cs Terminat e P r ocess 

C Interfaces 

VOID 

p t e r rn (c o d e) 

WORD code? 


P a r a m e t e r B1 o c k ;i 

C) I f u n c 1 1 o n c o d e 4 C I 
2 ! code ! 

Parameters!; 

c o d e E x i t c o d e r t u r n e d t o p a r e n t p r o c : ess f r o m 

Load or Execute a Process <4B) «. 


R e t u r n V a 1 u e s s 
Register DO.L s 

E r r cd r c: o d e o n f a i 1 u r e 


D e Ei- c r i p t i o n n P _ T E R M t e r - rn i n a t e s t h e c u r r e n t p r o c e s a n d t r a n s f e r s c a n t r o 1 

t o t he ca 11 i ng pr ocess« A11 f i 1 es op ened hy t he 

t e r rn i n a t i n g p r c:« c e s s a r e* c 1 c:> s e cl« 
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4.8 MEMORY MANAGEMENT FUNCTIONS 

T h i s s e c t i o n d e s c r i b e s t h e f o 11 o w i n g G E M D 0 S f u n c t i o n c a 11 s s 

* A11 q c a t e M e m o r y (M.A L L 0 C, 4 8 > 

* l :;: ' r e e A11 o c a t e d M e rn o r y < M F E E E , 4 9) 

* Shrin k Siz e of A11ocated Memory <M_SHRINK, 4A) 

M F'REE (49) and M_SHRINK calls require the address of a memory block 

p r e v i o u s 1 y ret u r n e d b y M.A L L 0 C (4 8) a s a p a r a m e t e r » M A L L. 0 C a 11 o c a t e s 

rn e m o r y i n u n i t s o f b y t e s a n d c a n a 1 s o b e u s e d t o r e t u r n t h e a m o u n t o f 

c: u r r e n 11 y a v a i 1 a b 1 e m e m o r y« 

The GEM DOS command line interpreter allocates all of available memory to 
rn o s t o f t h e p r o g r a m s t h a t a r e I o a d e d u n d e r i t s c o n t r o 1 « 

F u n c t i o n 4 8 s A1 1 o c a t e M e rn o r y 


C Interfaces 


LONG 

m.a 11 o c (n b y t e s) 

LONG nbyt.es s 


P a r a m e t e r B1 o c k s 




0 i f u n c 1 1 o n c o d e 4 8 I 



•+• mbytes •+• 




Parameters: 


mbytes 


f h e n u rn b e r o f b y t e s t o a 11 o c a t e o r 
-1L < F F F F F F F F ) t o r e t u r n t h i e m a x i m u. m 
a rn o u n t o f a v a i 1 a b 1 e rn e rn o r y 


R e t u r n V a 1 u e s s 
R e g i s t e r D 0. L s 

b 1 o c: k s s1 a r t :i n g a d d r e s s 

N u rn b e r o f a v a i 1 a b 1 e b y t e s 
(mbytes = FFFFFFFF) 

0 on failure 

Descriptions If the mbytes field of the MALLOC parameter block 

s p e c i f i e s t hi e n u. m b e r o f b y t e s o f m e m o r y t o a 11 o c a t e t h e 
fun o tion call r et ur n s a poin t er t o t he st artin g ad dr ess of 
a memory b1oc k in DO«L. If the a11ocation operation f ai1s ? 
.0 0 „ L r e? t u r n s z e r o« 

I f y o u s €51 n b y t e s t o -1L (F F F F F F F F) , M.... A L L 0 C r e t u r n s t h e 
m a h i m u m n u rn b e r o f a v a i 1 a b 1 e b y t e s« 
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Function 49s Free AIIocated Memory 

C interfaces 

LONG 

m.tree (maddr) 

LONG mad dr r* 

L 


F‘ a r a m e t e r .81 o c k s 

0 ! f u. n c 1 1 a n c a d e 4 9 « 

* t 

J 1 

t maddr t 

4 1 I 

a r a m e t e r s s 

m a d d r S t a r t ;i. n g a d d r e s s o t m e m o r y b 1 o c k t o b e t ; r e e d 

R e t u r' n V a i u. e s s 
R e g i. s t e r D 0 * L a 

• -40L (1 n va 1 1 d memor y b 1 oc k addr ess > 

D e s c r i p t i o n s M _ F R E E r e t u r n s ai m e m o r y I::) 1 o c k p r e v i o u s i y all o c: a t & d b y 

M.A L L 0 C (4 8) t o t h e s y s t e m«, 11 t h e m a d d r t i e l d o f t h e 

p a r a m e t r b .1. o c. {•=: d o e s n o t s p e? c: i f y a n a d cl r e s s t h a t w a s 

returned by a previous ALLOC call, M.FREE; returns -40L in 

DO „ L t o i nd i cat e t hat you have used an i n va l i d memor y b 1 oc; k 
address* 
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F u n r t i o n 4 A s 8 h r i n k S i z e o f A11 o c a t e d M e m o r y 

C Interfaces 

LONG 

rn .... s h r i n k < r e s, rn p , s i z e) 
r es 3 

BYTE! *mp; 

LONG size; 


P a r a m e t e r B1 o c I : 

0 I f li n c t i o n c o d e 4 A I 

2 ! Must be 0 1 

4 I ! 

rnp 

<b 1 I 

8 i 1 

•+• size ■+■ 

A I ! 


Parameterss 

m p B e g i n n i n g a d d r e s s o f m e m o r y b 1 o c k t o b e r e t u r n e d 

si ze Length , i n bytes h a t memory to be returned 

R e t Li r n V a i u e s 3 

•~40L (1nval i d memory b1 ock address) 

6 7 L (6 r o w t h r e s t r i c t i o n t a i I u r e) 

Descriptions The word at offset 2 in the parameter block is reserved tor 

s y s t e rn u. s e a n d m u s t I;::* e z e r o* rn p rn u s t s p e c i f y a m e m o r y 

b 1 o c k a cl cl r e s s t h a t w a s p r e v i o u s 1 y r e t u r n e d b y IT.AL L 0 C (4 8) . 

1 f t h e v a 1 u e y o u p a s s t o IT..... S H RIN K i n t h es s ize fie I d o f t h e 
p a r a m e t e r b 1 o c k d o e s n o t s p e c i t y a r e d u c t i o n i n t h e m e m o r y 
b 1 o c k s i z e, IT ..... 8 H RIN K r e t u r n s •*••• 6 7 L i n D 0« L 

Use SHRINK to return memory that your program does not 
r e q u i r e t o t h e s y s t e rn f o r a 11 o c a t i o n t o o t h e r p r o c e s s e s« 

B e t o r e c a 11 i n g M.8 H RIN K * m o v e y o u. r p r o g r a m ' s s t a c k s p a c e 

d o w n i n t o a n a r e a o t m ev m o r y t h a t y o u h a v e p r e v 1 o u s 1 y 
r e s e r v e d a n d k n o w w i. 1 1 a c c o rn o d a t e y a u r pro g r a m s s t a c k 
si ze» 

I f y o u r p r g r a rn 1 a t e r r e q u i r e «•!• a r.:i d i t i o n a 1 m e rn o r y , cal 1 

l v l.A L L 0 C t o cl e t e r m i n e t h e a m o u n t o t m ca rn o r y a v a i 1 a b 1 e (n b y t e s 

.1 > « Then call M.ALLOC with mbytes set to the portion of 

a v a i. 1 a b 1 e m ca m o r y y o u r r e q u i. r e s« 
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4.9 TIME FUNCTIONS 

This section describes the Get Date (2A) ? Set Date (2B), Get Time (20, and 
8 e t T i m e (2 D) f u n c t i o n s. 


F u n c: t i o n 2 A s 6 e t D a t e 


C i n t e r t a c e s 


WORD 

t_getdate «• ) 


P a r a m e t e r B1 o c k s 


O 1 f ia n c t i o n c o d e 2 A I 


R e t u r n V a i u e s s 
R e g i s t e r D 0 * W s 


Bi is 

00 

— 04 

Day, 

1 - 31 


Bi is 

05 

-- 08 

Month 

, 1 - 12 


Bits 

09 

- 15 

Year 

(since 1980), < 

:> - 119 


F u n c t i o n 2 B s 8 e t D a t e 


C Interfaces 

LONG 

t.s e t d a t e (d a t e) 

WORD date; 


P a r a m e t e r B1 o c k s 

0 I t u n c t i o n c a d e 2 B » 
2 I date I 


P a r a m e t e r s s 

date Contai ns the date to be set i n the t or mat s 

Bits 00 - 04 Day, 1 - 31 

B i t s 0 5 0 8 M o n t h , 1 - 12 

B i t s O 9 15 V e a r (s i n c e 198 O) , 0 - 119 


R e t u !-• n V a 1 u e s s 
R e g i s t e r D 0« L s 


1L (E r r o r) i t d a t e i s n o t v a 1 i d 
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F u n c t i 0 n 2 C s 6 0 1 T i m 0 


C Interfaces 

WORD 

t_gettime () 


F“ : a r a m 0 1 0 r B1 0 c k s 


0 I t u nt i o r* c 0 d e 2 C I 


R 0 1 u r n V a 1 u 0 
Reg 3 . ster DO* 


B i t s 

00 

04 Bxnary 

number 

Qf 

tw 0 ~s 0 c 0 nd merem 0 nts 

Bits 

05 •• 

10 Binary 

number 

Of 

mi nut 03 

Bi ts 

11 . 

15 Bx nary 

number 

of 

hours 


F u n c: i i o n 2 D 2 S 0 1 T i m 0 


C Interfaces 

LONG 

t _ -3 0 11 i rn 0 < t x iTi 0 ) 

WORD time 5 


P a r a m 0 1 0 r B1 o c k s 

0 I *f u n c t i o n c 0 d 0 2 D I 
2 ! t .i. me ! 


P a r a m 0 1 0 r s s 


t x iirt 0 C 0 n t a i n 3 t h 0 t i rn 0 1 0 b 0 s 0 1 x n t h 0 f 0 r rn a t s 


B i t s 00 - 04 B 1 n a r y n u m b 0 r 0 1 t w 0—0 c o n d 1 n c: r 0 m 0 n 1 3 

B i t s 0 5 ~ i 0 B i n a r y n u rn b e? r 0 f m i n u 1 0 s 

8i t s :L :i. - :l 5 Bi n ar y nurnber of hour s 


1L (E r r 0 r ) i t t x m 0 x s n 0 1 v a 1 x d 


R e t. u r r "1 V a l u s 
R 0 g i 3 1 0 r D <J« L. 


End 0 1 S 0 ction 4 
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A 8 &> 8 A S S E M B L E K 


5« 1 ASSEMBLER OPERATION 

f h e 8 El M D 0 £> A s s e m b 1 e r ,, A S 6 8 s , a s s e m b 1 e? s a n a s s e m to 1 y 1 a n g u a g e s o u r c: e p r o g r a rn 
f o r e k e c u t x o n o n t h e 68000 m x e r o p r o c e s s o r « 11 p r o d u. c e s a r e I o c a t a b 1 e 

o to j e c t f x i e a n d ,, o p t x o n a I 1 y a 1 i s t x n g „ Y o u c: a n f x n d a s u rn m a r y o f t h e A S 6 8 
instruction set at the end of this sectxon« Exceptions and additions to 
t h & s t a n d a r c:i M o t o r o 1 a i n s t r u c: t i o n s e t a p p e a r i n s e c t i o n s 5« 6 a n d 5 * 7 * 


5.2 INITIALIZING AS68 

I f t h e f i 1 e A S 6 8 B V M » D A T i s n o t o n y o u r d i s k , y o u rn u s t create t h i s f i 1 e t o 
initia1ize AS68 to ef ore you can use AS68 to assemh1e fi1es« To initia1x ze 
A S 6 8 , s p e c:: i f y t ti e A868 c o rn m a n d , t h e -1 o p t i o n 9 a n d 11 « e? f i 1 e n a m e A S 6 31 NIT a s 
shown beIow. 

i a}A868 -I AS68INIT 

A8 6 8 c r e a t e s t h e o u t p u t f i 1 e A S 6 8 S V M B u D A T h w h i c h A 8 6 E< r ea q u i r e s w i "i e n i t 
a s sh- e m to I e s p r o g r a m „ A f t e r" y o u c r e a t e t h i s f i ]. e «, y o u n e e d n o t s p e c i t : y t h i s 
c o rn rn a n d i i n e a g a i n u n 1 e s s y o u r e c o n f i q u r e y o u r s y s t e rn t o h a v e d i f f e r e n t T F :: ‘ A 
tooundaries. 


5.3 INVOKING THE ASSEMBLER (AS68) 

Invoke A868 by entering a command with the following forms 

AS68 [.F pathname] C-P3 L~S pathname] C-LL! C—L3 l .N3 l-l 1 

L 0 o to j e c t f i i e n a m e 2 

s o u r c e p a t h n a m e C > I i s t i n g p a t h n a m e 2 

T a to 1 e 5 -1 i i s t s a n d d e s c r i to e s t h e A868 c o rn m a n d 1 i n e o p t i o n s „ 
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• vj 


Tab1 0 5—1» Assemb1er Options 


Option 


Meaning 


• F p a t h n a m e 8 p 0 c: x f i 0 s t h 0 d i r 0 c: t o r y i n w h i c h t h 0 1 0 rn p o r a r y f lies a r 0 

c: r 0 a 1 0 d « I f t h x s o p t i o n x s n a t s p e c: i f x 0 d * A868 ere a 1 0 s t h e 
t e m p o r a r y f i 1 0 s i n 11" ! 0 c u r r 0 n t d 0 f a u 11 d i r 0 c t o r y.. 

.I I n i t i. a 1 i z e s t h 0 a s s 0 rn b 1 0 r« 8 0 0 S 0 c t x o n 5« 2 f o r d 0 1 a i I s „ 

.p I f s p 0 c i f i c: 0 d , A868 p r o d u c 0 s a n d p r i n t s a list i n g o n 11 *10 

standard output d 0 vic 0 , whx ch , by d 0 f auit, is th 0 c:onso 1 0 „ 
R 0 d x r 0 c t t h 0 i :i s t .i n g , x n c 1 u d i ri g 0 r r o r rn 0 s s a g 0 s, t o a f i 1 0 
w x t h t b 0 > 1 x s t i n g f i 1 0 n a m 0 p a r a m 0 1 0 r « N o t e t h a t 0 r r o r 
rn 0 ssag 0 s ar 0 produc: 0 d wh 0 1her or not th 0 -P opti on is 

s p 0 c x f x 0 d „ N o 1 1 s t i n g x s p r o d u c 0 d ,, h o w 0 v 0 r , u. n 1 e s s y o u 
s p 0 e: x f y t h 0 - P o p i i o n « 

-8 pathnam 0 1 ndxca1 0 s th 0 dir 0 ctory that contaxns th 0 ass 0 mb 1 0 r 

x n i t i a i i z a t i o n f i 1 eh , A S 6 8 S Y M B» D A T „ T h i s f i 1 e i s c: r 0 a 1 0 cl 
when you initialxz 0 AS68« AS68 reads the tile AS68SYMB«DAT 
b 0 f o r 0 x t a s s 0 m b 1 e s a s o u r c e t i 1 0 » I f y o u d o n o t s p e c i f y 
t h x s o p t x o n », A868 a s s u m 0 s t h 0 i n x t i a 1 i z a t i o n f 3 .1 0 i s 1 o c a 1 0 d 
i n t h 0 c u r r 0 n t d eh t a u 11 d x r 0 c t o r y, 


U C a u s 0 s a 11 u n d e f i n 0 d s y rn b 0 1 0 i n t h 0 a s s e m b 1 y t o b 0 t r 0 a 1 0 d 

a s g i o b a 1 r 0 1 0 r 0 n c 0 s« 

L E n s u r e s a 11 a d d r e s s c o n s t a n t s a r 0 g 0 n 0 r a t e d a s 1 o n g w o r d s „ 


U s 0 t h 0 .L c;:» p t i o n f o r p r o g r a rn s t h a t r 0 q u 1 r e m o r 0 t h a n 6 4 K 

f o r 0 k 0 c: u t x o n o r x f t h 0 T P A x s n a t c: o n t a i n © d in t h 0 f 1 r s t 
64 K bytes of memory. If ~~L is not specified, the program is 
a s s 0 m b 1 0 d t o r u n i n t h 0 f i r s t 6 4 K h y 1 0 s o f m 0 m o r y» I f a n 
a cl cl r 0 s s i n t h 0 a s s 0 m h i y d o 0 s n o t i i t w i t h i n o n 0 w o r d , a n 
e r r o r o c c u r s« 

.N D i s a b 1 0 s* o p t x rn i z a t i o n o f b r a n c: h 0 s o n f o r* ward r 0 f 0 r 0 n c e? s» 

Nor ma 1 i y , A 868 uses t h0 2 -by 1 0 t or m of t h0 cond i t i ona 1 
b r a n c h a n d t h 0 4 - b y 1 0 B 8 R i n s t r u c t i o r« w h 0 r 0 v 0 r p o s s i b 1 0 

< i n s 1 0 a d o f t h 0 6 —b y 1 0 3 8 R i n s t r u c t i o n > t o s p e 0 d p r o g r a m 
0 k 0 c: u. t i o ri a n cl r 0 t:l l.i c 0 i n s t r u c: t i o n s i z 0 „ 

. 1 E n a b 1 0 s A 868 t o a c c 0 p t t h 0 680.10 rn i c r a p r a c 0 s s a r o pc odes „ 

o u r c 0 f i 1 0 n a m 0 

8 p/ 0 c i f i 0 s t h 0 f i I 0 t o a s s 0 rn b 1 0; y o u. n i u s t s u p p 1 y t h i 
parameter„ 

> 1 1 sting fi 1 en ame 

8 0 n cl s a p r o g r a m 1 i s t ing to t h 0 s t a r*i d a r d o u t p u t d 0 v ice. U s e 
t he gr eat er-t ha\n symbo 1 , > ,, t o d i r ec: t t he I i st i ng t o a d i sk 

f i 1 0T h e 1 i s t i n g i n c: I u d e s a s s e rn b I 0 r 0 r r o r m e s s a g 0 s-« N o 1 0 

t h a t i f y o u d o n o t s p 0 c i f y .P w 1 1 h a 1 i s t i n g f i 1 0 n a m 0 , o n I y 

t h 0 0 r r o r m 0 s s a g 0 s a r 0 r 0 d i r 0 c: 1 0 d t o t h 0 i i s t i n q f i 1 0 „ 
















5« 4 ASSEMBLE 
Table 5—2 li« 

Di red: i ve 

« comm 1 abel , t 


» data 

u bss 

„ dc operand l 


6 e m D o s D o c u m e n t a t :l o n 
S e r i a 1 N u rn b e r 006738 


/ LANGUAGE DIRECTIVES 
;> t s t h e A S 6 8 d i r e c: t i v e s.. 


Tab 1 e 


A S 6 8 D i r e c: t i v e s 


Meaning 


expression 

T h e c o m m < c o rn m o n ) d i r e c 11 v e s p e c i f 1 e s a 1 a b e I a n d t h e s i z e 
of a common area that programs assembled separately can 
share. The L068 linker links all areas with the same label 
to the same address. The largest common area of a group 

wit h t he s ame label d et ermin es t he fina1 siz e of th e 

p r d g r a m c: o m m o n a r e a« 

i" h e d a t a d :i. r e c t i v e i n s t r u c t s A S 6 8 t o c h a n g e t h e a s s e rn b 1 e r 

b a s e s e q rn e n t t o t h e d a t a s e g m e n t« 

f‘he bss < b 1 ock stor age seqment) d.i rec: 1 i ve i nstructs AS6:*8 to 
c h a n g e t h e a s s e m b 1 e r b a s e s e g m e n t t o t h e b 1 o o k s t o r a g e 
s e g m e n t« V o u c a n n o t a s s e m b 1 e i n s t r u c t i o n s a n d d a t a i n t h e 
b s s n H o w e v e r , y o u c a n d e f i n e s y m b o 1 s a n d r e s e r v e s t o r a g e 
in the bss with the ds directive. 


operand ? » .. « 1 

T h e d c < d e f :i. n e c o n s t a n t) d i r e c t i v e d e f i n e s 
c o n is t a n t s i n m e m o r y. T h e o p e r a n d s c: a n 
e x p r e s s i o n s a s s i q n e d n u rn eric v a 1 u e s b y A S 6 8 , 
n u m e r i c c o n s t a n t s i n d e c i m a 1 o r h e x a d e c i m a 1 , 
ABC11 char act er s„ You must separate operands 


one or more 
be symbols or 
or expiicit 
o r s t r i n g s o f 
with commas. 


You must enclose string constants in single quotation 
mar k s« Eac h ABC 11 c h ar ac t er i s ass i q n ed a f u 11 b y t e of 
m e m o r y« T h e e i g h t h b i t i s a 1 w a y s 0« 


Y o u c a n s p e c i f y t h e 1 e n g t h o f e a c h c o n s t a n t w i t h a s i n g 1 e 

letter parameter (byte « b, word » w 9 longword « 1). You 

m u s t s e p a r a t e t h e 1 e 11 e r f r o m t h e d c w i t hf a p e r i o d a s s h o w n 

i n t It e f o 11 o w i n g e x p 1 a n a t i o n s „ 

.dc.b The constants are byte constants. If you 

s p e c i f y a n o d d n u m b e r o f b y t e s 9 A868 f i 11 s 
t h e o d d b y t e o n t h e r i g h t w i t h z e r o s u n 1 E-? s s 
t he nex t st at ement i s another dc „ b 
d i r e c t i v e« W h e n t h b n e x t s t a t rn e n t i s a 
d c« b d i r e c t i v e H t h e d c . b u s e s t h e o d d b y t e« 
B y t e c o n s t a n t s a r e n «: *j t r e 1 o c a t a b 1 e 
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Tab1e 5-2« <continued) 


Directive 


lie an i ng 
:< dc« w 


. dc:» i 


The cons taints are word constants* If you 
s p e c i. f y a n o d d n u m b e r o f b y t e s , A868 f i 11 s 
t h e i a s t w o r d o n t h e r 1 g h t w i t h z e r o s t o 
f o r c e a n e v e n b y t e c o u. n t • T h e o n 1 y w a y t o 
s p e c i t y a n o d d n u m b e r o f b y t e s i s w i t h a n 
A 8 C11 con st an t» Word c ons tants can b e 

relocated« 


T h e c o n s t a n t s 
less than a 
entered, AS68 
the right with 
four bytes* 
relocated« 


ar e I ongword constan t s« 
m u 11i p 1 e o f f o u r b y t e s 
f i 11 s t h e 1 a s t 1 o n g w o r d 
z eros to force a mu11ip1e 
L o n g w o r cl c o n s t a ri t s c a n 


I f 
i s 
on 
of 
be 


«ds operand The define storage directive (ds) reserves memory 

1 a cations. The contents of the memory that it reserves is 
n o t i n i t i a 1 i z ed * Th e op er an d sp ec i f i es t h e n umb er of 

bytes , words, or 1 ongwords that this direct i ve reser ves,, 

T I"! e n o t a t i o n f o r t h e s e s ize s p e c i f i c a t i o n s i s s h o w n b e 1 o w * 

« d s. b r e hb- e? r v e s m e m o r y 1 o c: a t i o n s i n h y t e s 

« cl s« w r e s e r v e s m e m o r y 1 o c: a t i o n s i n w o r d s 

* ds«1 r eserves memory 1ocations in 1onqwords 


« end 


„ endc 


. equ (or 


The end directive informs AS68 that 
f o 1 1 o w s t h i s d i r e c t i v e * C o d e ^ 
c a r* r i a g e r c: t u r n s c a n n o t 1 ; o 1 1 o w t h i s 


no more 
comments, 
directive, 


source code 
or muitipie 


The endc directive denotes the end of the code that is 
c on d i t. i on a 11 y assemb 1 e?cl« 11 i s used with ot h er d i r ec t i ves 

t h a t c o n i. t i a n a 11 y a s s e m b 1 e c o d e. 


expression 

Tf"ie &q uat e d i r ect i ve < equ or =) assigns t he vai ue of t h & 
enpression in t he oper an d field t o t h e symbo1 in t h e 1ab e1 
fie1d t hat preced es th e dir ective« The synt axes f or t h & 
e q u a t e d 3. r e c t i v e a r e 

1 ahel * equ e*xpr ss i on 
j. a b e 1 ::::: e x j::? r e s s i o n 
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fab 1 e 


(continued) 


Directive 


Meaning 


1“ h e 1 a b e 1 a n d o p e r a n d f i e 1 d s a r e r e q u i r e d« T h e 1 a I::) & 1 m u © t 

be uniquesj i t cannot be def ined anywhere e 1 se in the 

p r o q r a rn» T h e e x p r e © s i o n c:: a n n o t i n c I u d e a n u n d e f i n e d © y m b o 1 

o r o n e t h a t i © defined f a 11 a w i. n g t h e e x p r e © © i o n » F o r w a r d 

r e i ; e r e n c e s t o s y m b o i © a r e n o t a 11 o w e d t o r t h i s d i r e c: t i v e. 

, even 1 he even d i rect i ve :t ncrement.s the 1 oc:a1 1 on counter ta f orce 

a n e v e n b o u n d a r y« F o r e x a rn p I e , i f © p e c i t i e d w h e n t h e 

1 cd c a t i cd n c o u n t e r i s o d d M t h e 1 a c: a t i o n c o u n t e r i is 

i n c r e m e n t e d b y o n e s o t h a t t h e n e x t i n © t r u c t i o n o r c:i a t a 

tieId begln © on an ev en boundary in memor y. 

, g 1 cdI:d 1 1 abel II h 1 abel « « « 3 
xdef 1 abel II , 1 abel „ . « 3 

, xret 1 abel II ,, 1 abel « ,, . I! 


T h e s e d i r e c: t i v e s rn a k e t h e 1 a b e 1 < s) e x t e r n a 1 « I f t h e 1 a b e 1 s 
a r e d e f i n e d i n t h e c u r r e n t a s semb 1 y 9 t h i s s t a t e m e n t rn a k e © 
them avai 1 ab 1 e to other rc:>ut i ne© dur i ng a load by L06 ‘8 « 11 

t h e 1 a b e 1 s a r e n o t d e f i n e d i n t h e c u r r e n t a s © e m b 1 y , t h e y 

b e c cd m eo u n d e f i n d e? k t e r n a 1 r e f e r e> n c e s «, w h i c h 068 1 i n k s t o 

e x t e r n a 1 v a 1 u e s w i t h t h e s a rn e 1 a b e 1 i n o t h e r r o u t i n e s „ I f 
y a u. ©p ec: i f y t h e ••••• U op t i cd n , t h e assembler ma k e© all 

u n 6 & i i n e cl 1 a b e 1 © e x t e r n a 1 * 


« i f eq 
« d. tne 
„ i t ]. e 
« i f 11 
. i f ge 
■ i+gt 


ex 

ex 

ex 

ex 

ex 

ex 


pressi on 
press!on 
press!on 
press!on 
press!on 
press!on 


T h e s e d i r e c t i v e s t e s t a n e x p r e s s i o n a cd a i n s t z e r cd f o r a 
s p e c i f i e d c o n d i t i o n« 11 t h e e x p r e s s i o n i © t r u e , t h e c: cd d e 

•f o 11 o w i n q i © a s © e m b 1 e d 5 i f f a 1 s e H t h e c cd d e i © i g n o r e d u n t i 1 
an end conditional directive (endc) is found- The 

d i r e c t i v e- s a n d t h e c o n d i t i o n t h e y t e s t a r e 3 


i f eq 

equal to z 

ero 

i f ne 

not equal 

to zero 

i f 1 e 

less than 

or equal to zero 

i f 11 

1 ess than 

zero 

i f ge 

greater or 

equal to zero 

if gt 

g r e a t e r t h a n z e r 0 
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T a b 1 e 5—2» (c a n t i n la e d > 


0 x r e c t i v e !i e a n x n q 

« x f c st r i n g 1 , st r i n g 2 

„ i f nc str x ng 1 ' st r x ng2 


T h e c: o n d i t i o n a I t r 1 n g d i r e c:: t i v e c o m p a r e s t w o s t r i n g s« T h e 
c: c o n d i t i c:) n i s t r u 0 :L f t h e s t r i n g s a r e e x a c: 11 y t h 0 s a m 0 « 

Th 0 nc con dition is t r ue it t hey d o n ot mat c h « 


« o f f s e t e x p r e s s x a n 

T h 0 o f f s 0 1 dire c t x v e c r e a t e s a d u rn m y s t o r a g e sect i o n b y 
d ef i ning a t ab1e o f off set s wit h t h e d efin e storage 
dir ec tive <ds) „ The stor age detinitions are not passed to 
the linkers, The offset table begins at the address 
spec x *f i ed i n t h ek p r ess i on » Sy mb o 1 s d ef i n ed in t h e of f set 
table are internally maintained. No instructions or 
code-generatinq directives H except the equate (equ) and 
register mask (reg) directives, can be used in the table. 
T h e o 11 s e t d i r e c t i v e i s t e r m i n a t & d b y o n e c::» t the f o 11 o w i n g 
di recti vesr, 


bss 
d a t a 
end 

sectx on 
text 


„org exp r ess x on Ih e ab so1ute origin directive (or g) set s t h e 1oc a t ion 

counter to the value o-f the expression. Subsequent 
s t a t e m & n t s a r a s s x g n & d a b s o 1 u t e rn e rn o r y 1 o c a t i o n s> w i t { • » t h e 
n e w v a 1 u e o t t li e 1 o c a t i o n c o u n t e r « T h e e x p r e s s i o n c a n n o t 
c o n t a x n a n y t o r w a r d „ u n d e t i n e d , o r e x t e r n a 1 r e f e r e n c e s „ 

.page The page directive causes a page break which forces text to 

print on the top of the next page. It does not require an 
operand or a label and it does not generate machine code. 


T h e p a g e d i r & c t i v e? a 11 o w s y o u t o s e t t h e p a g e 1 0 n g t h f o r a 
listing of code. If you use this directive and print the 
source code by specifying the -P option in the AS68 command 
1 i n e 9 p a g e s h r e a k a t p r e d e f i n e d r a t hi e r t h a n r a n d o m p 1 a cr. e s« 
T h e p a g e d i r e c t i v e^ d o e s n o t a p p e a r o n t h e p r i n t e d p r o g r a rn 
1isting « 
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f a b 1 e 5 2« (c o n t i n u e d ) 


Directive 


Meaninq 


„ req r eg 1 i st i h e r eg i st er mas k d i r ec 11 ve b u 1 1 d s a r eg i st er mas k t h at c an 

b e u s e d b y a m o v e rn i n s t r u c t i o n » (8 e e 1 a b I e 1 -1. > □ n e q r 

m o r e r e g i s t e r s c a n b e 1 i s t e d i n a s c © n d i n g o r d e r :L n t h e 
formats 

R?C-RC/R7C-R?. . . 3 . - - 33 

R © p 1 a c e t h e R i n t h e a b o v e f o r rn a t w i t h a r e g i s t © r 

reference. Any of the following mnemonics are valids 

A0-A7 
DO-07 
R0-R15 


Th© f o 11 ow i ng ex amp 1 e i 11 List r at es a samp 1 e r eg i st ©r I i s t. 
A2-A4/A7/D1/D3-D5 

V o u c a n a i s o u s e c: o rn m a s t o s e p a r a t e r © g i s t © r s a s f o 11 o w s s 
A1,A2,05,D7 

.section # The section directive defines a base segment. The sections 

c a n b e n u m b e r e d f r o m 0 t o 15 i n c i u s i v e. 8 e c t i o n 14 a 1 w a y s 

rn a p s t o d a t a • S c t x o n 15 i s b s s« A11 o t h e r s © c t i o n 
n u m b e r s d e n o t e t e x t s e c t i o n s . 

.text The text directive instructs AS68 to change the assembler 

b a s © s e g m e n t t o t h e t e x t s e g m e n t. E a c h a s s e rn b 1 y o f a 
pr og ram b eg i ns wit h t he f i r st w o r d in t h e t ex t segm©n t« 


5.. 5 SAMPLE COMMANDS INVOKING AS68 
•(.' a } a s 6 8 - u -1 test, s 

This command assembles the source file* TEST.3 and produces the object file 
TEST.0. Error messages appear on the screen. Any undefined symbols are 
treated as g 1 oba 1 . 

i a > a s 6 8 •- p s rn p 1 . s > s m p 1 . 1 

This command assembles the source file SMPL.S and produces the object file 
8 M P L. 0« T h e p r o g r a m m u s t r u n i n t h e f i r s t 6 4 K o f m e m o r y 5 t h a t i s , n o 
address can be larger than 16 bits. Error messages and the listing are 
d i r e c t e d t o t h e f i 1 e 8 M P L«i.. 
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5 .6 ASSEMBLY LANGUAGE DIFFEEENCES 

The synta h di f f erences between the AS68 assernb I y 1 anguage and Motor o 1 a s 

a s s e m b 1 y 1 a n g la a g © a r e d © s c r * i b © d i n t h © t o 11 o w i n g 1 i s t • 

* I n AG 6 8 , a I ! ass© mb i ©r d i r ec t i ves ar © opt :i. on a 11 y p r ©c ©d ©d b y a p ©r i od 

(«)« For ©k amp1 ©„ 

«equ or equ 
.ds or ds 

* A868 d o © s n o t s la p p o r t „ b u t a c c © p t s a n d i g n o r © s t h © -f o 11 o wing M o t o r o 1 a 
directives!! 

com! i ne 
mask 2 
:l. dnt 
opt 

* F h © 11 o t o r o 1 a .. s © t d i r © c t i v © i s i m p 1 © m © n t © ci a s t h © © q u a t © d i r © c: t i v © 

(equ)« 

* A868 a c c © p t s u p p © r •••*• and lower© a s © c h a r a c t © r s „ V o u c a n s p © c i t y 

i n s t r u c t i o n s a n d d i r © c t i v © s i n © i t h © r c a s ©. H o w © v © r , 1 a b © 1 s a n d 

variab1©s ar© case-sensitive» For examp1 ©, the 1ab©l START and Start 

a r © n o t © q u i v a 1 © n t« 

* P" o r A S 6 8,, a 11 1 ab © 1 s m u s t t © r m i n a t © w i t h a c o 1 o n < s ) . F o r © x a m p 1 © ,, 

A s 

FOOs 

H o w © v © r n i + a 1 a b © 1 L © q i n s i n c o 1 u m n 1 , it n © © d n c:> t t © r m i n a t © w i t h a 

col on» 

* F c:> r f ; i E> 6 8 A S C11 s t r i i "! g c o n s t a n t s c: a n b« © © n c 1 o s © d i n © 1 1 h © r s i n q 1 © o r 

d o u b 1 © q u o t © s« F o r © x a m p X © „ 

ABCD 
u at: 14 n 

* F' o r A E> 6 8 H r © c:i i s t © r s c a ri b © r © t © r © n c e d w :i. t h t h & f o 11 o w i n g m n © m o n i c: s s 

rO 
RO 
dO 
DO 
aO 
AO 

U p p ©r •• a n d 1 o w © r c a s © r © t © r © n c © s a r © © q u i v a 1 © n t „ E © g i ii*> t © r s F : < 0 F< 7 a r © 

t h © s a m © a s D 0— D 7 a n d R 8—R15 a r © t h © s a m © a s A O — A 7 « 

* Us© caution when manipulating th© location counter forward in ASo8» An 

© x p r © s s i o n c a n m o v © t h © c o u n t © r f o r w a r d o n 1 y „ T h © u n la s © d s pace i s 

t i 1 1 ©d w i t h z ©r os i n t h © t ©x t or d at a se-?g men t s« 


E15 
•d? 

■ *D7 
-a7 
A / 










6 e rn D a s D o c u m e n t. a 13. a n 
S e r i a i N u m b 0 r 006738 


F o r A S 6 8 , c o m m 0 n t 1 i n 0 s c a n b e g i n w i t h a n a s 1 0 r i s k f o 11 a w 0 d by a n 

0 q u a 1 s s i g n (* =) h b u t o n 1 y i t o n 0 o r m 0 r 0 s p a c: 0 0 0 x i s t b e t w 0 0 n t h e 

a s 1 0 r i s k a n d t h 0 0 c| la a 1 s s i g n a 0 f o Ho w ss 

* Th i s c ommand 1 oads R 1 wit h z er os» 

* B r a n c h t o s u h r o u t i n 0 X Y Z« 

B 0 s u r 0 1 0 i n c 1 u d 0 a s p a c 0 a 11 0 r t h 0 a s 1 0 r i s k * a s t h 0 1 0 c a t i 0 n c 0 u n t0 r 

i. s m a n i p u. 1 a 1 0 d w i t h a 0 1 a 1 0 rn e n t o t t h 0 1 0 r rn s 

* as ©xpr 

F a r A 568 «, t h i 0 s y n t ax x f 0 r s h 0 r t 1 0 r m b r a n c h 0 s i s b x x * b r a 11 - ! e r t h a n b x x « s 

T h 0 H 0 1 0 r 0 1 a a s s 0 rn b 1 0 r s u p p 0 r t s a p 0 g r a m rn i n g rn 0 d 0 1 i n w h i c: h a p r o g r a m 
c: 0 n s i s t 0 1 ; ai rn a x i rn u. rn 0 f i 6 s e f:) a r a 1 0 1 y r 0 1 0 c: a t a b 1 e b e c:: t i 0 n s a n cJ a n 
optional absolute section. The A 868 distributed with BEMDGS does not 
s u p p 0 r t t h i s rn 0 d 0 1 .. I n s t e a d * A S 6 8 s u p p 0 r t s a rn o d 0 1 i n w h i c h a p r 0 g r a m 
c o n t a i n s t i r 0 0 s 0 g m e n t s , 1 0 x t, d a t a,, a n d b s s a s d 0 s c r i b 0 d i n S e c t i 0 n 3 ? 

* 1 C 0 rn m a n d F' i 1 0 F 0 r m a t ,= f * 
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5.7 ASSEMBLY LANGUAGE EXTENSIONS 


T h i e f o i 1 d w i n q e n h a n c e rn e n t s hi a v e b e e n a d d e d t a A S 6 8 t o m a k e t hi e a s s e m b I y 
1 a n g u a g e m o r e e f f i c i e n t s 

N h e n t hi e i n s t r u c t i o n s a d d , s u b , a n d c m p a r 0 u s 0 d w i t h a n a d d r 0 0 s 

r 0 g i s t0 r 3. n t h 0 0 o u r c: 0 a r d 0 s t i n a t ion, t h 0 y g 0 n 0 r a 1 0 a d d a , s u b a , a n d 

c : m p a« W h 0 n t h 0 c 1 r i n s t r u. c t i o n i s u s e d w i t h a n a d d r e 0 s r g i s 1 0 r (A x ) , 

i. t g 0 n 0 r a 1 0 s s u b A x , A x« 


* ad d «, and , c mp , eor , or , sub ar 0 a 1 I 0w0d w i t h i mrn0d i a 1 0 f i r st op 0r an d s 

a n d g 0 n 0 r a 1 0 a d ci 1 „ a n d i , c m p i , 0 o r i , o r i , a n d s u b i instr u c t i o n s i f t h 0 

s 0 c: o n ci o p 0 r a n d i s n o t r 0 g i 0 1 e r - d :i. r 0 c t« 

* All branch instructions generate short relative branches where 

p o s s i b 1 0 , i n c 1 u d i n q f o r* w a r d r 0f e r 0 n c:: 0 s« 


* Any shift instruction with no shift count specified assumes a shift 
count of one- For example, asi rl is equivalent to asl #i,rl« 

* A jsr instruction is changed to a bsr instruction if the res suiting hsr 
1 n s t r - u c:: t i o n i s s h o r 1 0 r t h a n t h 0 j s r i n s t r u c t i o n « 


* The -text directive causes the assembler to begin assembling 

1 n s t r u c: t i. o n s i n t h 0 (: e x t 0 g m 0 n t „ T h 0 - ci a t a ci i r 0 c t i v 0 c a u s 0 s t hi 0 

assembler to begin assembling initialized data in the data segment. 

* f h 0 b s «;> ci i r 0 c: t i v 0 i n s t r u c t s t h 0 a s s 0 m bier t o b 0 gin d 0 f i n i n g s t o r a g 0 i n 

t h 0 b s s „ N o i n s t r u c t i o n s o r c o n s t a n t s c a n b e p 1 a c e d 1 n t h e b s s b 0 c a u s 0 
t hi 0 b s s i s f ci r u n 1 n i t i a 1 i z 0 d ci a t a o n 1 y» H o w 0 v 0 r , t h 0 «ci s d i r 0 c t i v 0 s 
can be used to define storage locations, and the location counter (*) 
c: a n b 0 i n c r 0 rn 0 n 1 0 ci - 

* T h 0 - g 1 cd b 1 d 1 r e c t i v e i n t h 0 f o r m s 

„globi 1 abel C ,Iabel 3 «- - 

m a h: 0 s i: h 0 1 a h e 1 s 0 x 1 0 r n a 1 .. 1 f t h 0 y a r 0 o t h 0 r wise cl 0 f i n 0 d (b y 

assignment or appearance as a label), they act within the assembly 
ex ae 11 y as i f the « g 1 ob 1 di rect i ve were not gi ven „ However , wheri 
1 i n k 1 ri g t h i p r o g r a m w i t h o t h e r p r o g r a m s , t h e s e s y m b o 1 s a r e a v a i 1 a h 1 e 
t cd o t h e r p r o g r a rn « C o n v e r s e 1 y , i f t h e g i v e n s y m bols ax r e n cd t d e f i n e d 
w i t h i n t h e c u r r cd ri t a s s e m b 1 y , t h e 1 i n k e r c: a n c o m b i n e t h e o u t p u t o f t h i s 
a si- si- e rn b 1 y w i t hi t h a t o f o t h e r s w h i c: h d e f i n e t h e s y m b o I s - 
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* 7 h e c o m rn o n d :i. r e c t i v e (c o m m) d e f i n e s a c o m m o n r e g i o n , w h i c h c a n b e 

a c c: e s s e d fa y p r o g r a ms t h a t a r e a s s e rn fa i e d s e p a r a t e I y. T h e s y n t a x f o r t h e 
c o m m o n d :i r e c t i v e i s 

. c o rn rn 1 a fa e i n e x p r e s s i o n 

The expression specifies the number of bytes allocated in the common 
r e g i o n . 1 f s e v e r a 1 p r o g r a m s s p e c i f y t h e s a m e 1 a fa e 1 f o r a c o m m o n 

r e g i o n , 11"} e s i z e o f t h e r e g i o n i s d e* t e r rn i n e d fa y t h e v a 1 u e o f t h e 

3. a r g e s t e x p r e s s i a n« 

The common directive assumes the label is an undefined external symbol 
:t n t h e c u r r e n t a s s e m I:) 1 y« H o w e v e r , t h e 1 i n k ee r , L □ 6 8, is s p e c i a 1 •- c a s e d , 
s o a 11 e x t e r n a 1 s y m fa o 1 s , w h i c h a r e n o t o 11"! e r w i s e d e f i n e d , a n d w h i «::: h 
h a v e a n o n—z e r o v a 1 u. e , a r e d e f i n e d t o b e i n t h e fa s s, a n d e n o u g h s p a c e 
i s 1 e f t a f t e r 1h e s y rn b o 1 t o h o 1 d e x p r e s s i o n fa y t e s» A11 s y m b o 1 s w h i c |-i 
fa e c o m e d e f 3. n e d i n t h i s w a y a r e 1 o c a t e d b e f o r e a 11 t h e e x p 1 i c i 11 y 

d e f i n e c:l fa s s 1 o c a t i o n s» 

’!" h e ,, e v e n d i r e c t i v e o a u. s e s t h e 1 o c a t i o n c o u n t e r < *) , i f p o s i t i o n e d a t 
a n o d d a d d r e s s t o b e a d v a n c e d b y o n e b y t e s o t h e n e x t s -1 a t e m e n t i s 
a s s e m b 1 e d a t a n e v e n a d d r e s s« 

■ft The instructions move, add n and sub, specified with an immediate first 
o p e r a n d a n d a d a t a < D) r e g i s t e r a s t h e? d e s t i n a t i o n , g e n e r a t e Q u i c k 
i n s t r u c: t i o n s , w h e r e p o s s i b 1 e» 


5.8 ERROR MESSAGES 

A p p e n d i x D 1 i t s t h e e r r o r rn e s s a g e s q e n e r a t e d fa y A S 6 8 
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5. 9 INSTRUCTION SET SUMMARY 

Th i s sec: t i on c: ont ai ns t wo t ab 1 es t hat desc: r i b e t h e assemh I er i nst r uct i on 
set distributed with GEMDOS„ Table 5-3 summarizes the assembler (AS68) 
i n s t r u c: 11 o n s e t „ T a b 1 e 5 - 4 1 i s t s v a r i a t i o n s o n t h e i n s t r u ctio n s e t 1 i s t e cl 
i n T a b 1 e 5 ~~ 3« F a r d e t a i 1 s a n s p e c i f i e i n s t r u. c t i a ns, ref e r t o M o t e* r o 1 a s 
1 6 ••••• B i t M i c: r o p r o c e s s o r U s e r s M a n u a 1 , t h i r d e cl i t i o n 9 M C 6 8000 U M ( A D 3) « 


7 a h 1 e 5 - 3« 1 n s t r u. e t i o n S e t S u. m m a r y 


I n s t r u c: t :t o n D e s c r 3. p t i o n 

a b c: d A cl c! D e c: i m a 1 w i t h E x t e n d 

add Add 

a n d L o g i c a 1 A N D 

a is 1 A r i t h m e t i c S h i f t L... e f t 

a s r A r i t h m e t i e S h i f t R i g h t 

h c c B r a n c h C o n d i t i o n a 11 y 

b c: h g B i t T e s t a n d C h a n g e 

h c 1 r B i t 7 e s t a n d C1 e a r 

b r a B r a n c h A1 w a y s 

hset Branch Test and Set 

b s r B r a n c: h t o S u b r o u t i n e 

b t s t B i t 7 e s t 

c h k C h e c k F< e g i s t e r A g a :i. n s t £3 o u n cl s 

c 1 r C1 e a r 0 p e r a n d 

crop Compare 

dbc c Test Cond i t i on , Decr ernen t, and Br an c:h 

d i v s S i g n e d D i v i d e 

d i v u. U n sign e ci D i v i cl e 

e o r E x c 3. u s i v e 0 R 

e x g E x c h a n g e R e g 1 s t e r s 

ex t Sig n Exten d 

3.11 e g a 3. 111 e g a 1 I n s t r u c t i o n 

jmp Jump 

j s r J u m p t o S u b r o u t i n e 

1 e a I... o a d E f f e c t i v e A d cj r e s s 

1 ink Link Stack 

3. s 1 L o g i c a 1 S h i f t L e 11 

1 s r L o g i c a 1 S h i f t E i g h t 

move Move 

m o v e m M o v e l y l u 11 i p 1 e R e g i s t e r s 

m o v e p M o v e P e r i p h e r a 1 D a t a 

rn u .1. s S i g n e d M u 11 i p 1 y 

rn u 1 u U n s i g n e d M u 11 i p 1 y 








GemDos Docutnentat i on 
Serial Number 006738 


Tab 1 e 5—3. (continued) 


1 nstruction 

Description 

nhcd 

N e g a t e D e e i rn a 1 w i t h E k t © n d 

neg 

Negate 

nop 

No Operation 

no 

0 n e s C o m p 1 e rr* e n t 

or 

Log!cal OR 

pea 

P u s h Ef1 e e t i v e A d d r e s s 

reset 

R e s e t E k t e r n a 1 D e v i c e s 

r o I 

Rotate Left without Extend 

r or 

R o t a t e R i g h t w i t h o u t E x t e n d 

rox 1 

Rot at e Left with Exten d 

r ok r 

R o t a t e R i g h t w i t h E x t e n d 

r t © 

R e t u r n F r o m E x c: e p t i o n 

r t r 

R e t u r n a n d F< e s t o r e 

r t s 

R e t u r n f r o m S u b r o u t i n e 

sbcd 

8 u b t r a c t D e c: i m a 1 w :i. t h E x t e n d 

see 

8 e t C o n d :L t i o n a 1 

stop 

Stop 

sub 

Subtract 

swap 

S w a p D a t a R e g i s t e r H a 1 v e s 

tas 

Test and Bet Operand 

t r ap 

fr ap 

trapv 

1 r a p o n 0 v e r f 1 o w 

tst 

Test 

uni k 

Un1in k 



Xnsti- 

add 

and 

omp 

ear 

move 


neg 

or 

sub 
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fabIe 5—4. Variations of Ins truction Types 


uction 


Var i atxon 


add 


Add 

ad da 


Add Address 

addq 


Add Quick 

addi 


A d d X m m e d i a t e 

addx 


A d d with Ext en d 

an d 


Logical AND 

andi 


A N D I m m e d i a t e 

and! 

to 

ccr 

andi 

t o 

sr 

crnp 


Compare 

c: mp a 


C o m p a r e A d d r e s s 

cm pm 


C o m p a r e M e m o r y 

e mp i 


C o rn p a r e I rri m e d i a t e 

ear 


Ex cl la si ve OR 

ear i 


Exc1usive 0E Xmmed 

ear i 

to 

ccr 

eor 1 

to 

sr 

move 


Move 

rnovea 

M o v e A d cl r e s s 

moveq 

Move Quiok 

move 

to 

c c r 

move 

t o 

sr 

move 

from sr 

move 

to 

usp 


neg 

negx 


or 
or i 

on to 
ori to 


Negate 

Negate with Extend 

Logical OR 
OR Imrnedi ate 

c c r 

s r 0 R I m m e d i a t e t o 81 a t u s R e q i s t e r 


sub 

Subtract 


sub a 

Subtract 

Address 

sub :i. 

Subtract 

Immediate 

subq 

Subtract 

Qui ck 

subx 

Subtract 

with Ex ter 


E n d o f S e c t i o n 5 
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GEM DOS LINKERS 


T w o I :l. n k e r s a r e p r o v i d e d w i t h G E li D 0 S s L IN K 6 8 a ri d L.068« B o t h c r e a t e 

r e I o c a t a b 1 e c o m rri a n d files i n t h e f o r m a t r e q u i r e d b y t h e o p e r a t i n g s y s t e m - 

N o t e t h a t b o t h LIli K 6 8 a n d L068 p r o d u c e f11 e s i n C P / li ••••• 6 8 K r e 1 o c a t a b 1 e 

format- Use the RELMQD format conversion uti1ity to translate 1 inker 
o u t p u t f i 1 e s f r o rn C P / li - 6 8 K f o r rn a t t o t h e G E! M D 0 8 r e 1 o c a t a b 1 e f o r m a t» 

R E L M 0 D i s d e s c r i b e d i n S e c: t i o n 6 - 3» 


6.1 LINK68 

LI li K 6 8 i s a 1 i n k a g e e d i t a r t h a t c o rn b i n e s o b j e c t f i 1 e s i n t o a c: o m m a n d f i I e - 

L1N K 6 8 a c c e p t s o h. j e c t f i 1 e s p r o d u c e d b y a t h e r J. a n g u a g e p r o c e s s o r s , s u c h a s 

AS68 or t he C compi1er « LINK68 pr oduces an executab1e fiIe in eit her 

c o n t i g u o u s c:« r n o n c o n t i g u o u s c: o m m a n d f i 1 e f o r m a t - N o n c o ri t x g u o u s e o m rn a n d 
f i 1 e s a r e n o t s u p p o r t e d b y 8 E! M D 0 S« S e e S e c t i o n 3 f o r a d e s c r i p t i o n o f t h e 
c a n t i g u o u. s f i 1 e f o r m a t» 

L INK68 r eso 1 v e s a 11 r e f e r en c es t o ex t er n a 1 sy mb o 1 s an d c: on c: a t en a t es t h e 

o b j e c: t f i 1 e s :i n t h e a r d e r s p e c i f i e ci - T h e e n t r y p o i. n t o f t h e r e s u 11 i n g 
c o rn rn a n d f i 1 e i si- t h e f i r s t i n s t r u. c t i o n i n t h e f x r s t o b j e e t f i 1 e 

N o t e s Y o u m u s t u s e L l li K 6 8 t o c r e a t e a n e x e c: u t a h 1 e c o m m a n d + 1 1 e e v e n w li e n a 

s i n g 1 e o b j e c: t f i 1 e c o n t a i n s n c::» u n r e s o 1 v e d r e f e r e n c e s» 

I f y o u u is- e t h e A8 6 8 c: o m rn o n d x r e c t i v e t o s p e c i f y a e o m m o n a r e a s h a r e d b y 

s e p a r a t e rn o d u 1 e s H L. I li K 6 8 r e s o Ives a 11 c o rn m o n a r e a s w i t h t h e s a rn e n a m e t o 

t h e s a m e a ci d r e s -Hi- x n t h e b s s s e g rn e n t. I f rn o r e t h a n o n e f i 1 e s p e c i f i e s 

t a t i c s t o r a g e w i t h 11? e s a m e n a rne , LIN K 6 8 u s e s t h e 1 a r g e s t s i z e f o r 

al1ocation« 


6 - 1» 1 I n v o k 1 n g L I li K 6 8 

To x ri vo k e LINK68 , ent er a comrnand of t he f o 11 owi ng f or m s 

LI lil<68 f i 1 e = 2 ob j ec t ~f i 1 e~~ 1 i , ob j ec t.f i 1 e~~2 , - „ « ob j ec: t.f i 1 e-n J 

I f y a u 1 n v o k e L. I li K 6 8 w i t h o u t a n y c o m rn a n d t a :i. 1 H t h e 1 i n k e r 1 i s t s t h e 

o p t i o n , a ri ci r o? t u. r n s t o t h e o p e r a t i n g s y s t e m« 

f h e f i r s t f i 1 e p e c x f i c a t i c::« n i s t h e n a m e o f t h e c: o rn m a n d f i i e y o u w a r i t t o 

c r e a t e ? a n d o h. j e c t - f i 1 e — 1 t h r o u g h o b j e c t f i 1 e -• n a r e t h e o b j e c t f i 1 e s t c:« 

1 i n k „ F o r e i =: a rn pi 1 e ^ t l i e f c» 11 o w i n g c: o rn rn a r i d c r e a t e s t h e o u t p u. t f i 1 e li A T H s 

[ a > 1 i n k 6 8 m a t h :::n s i ri „ c o s q t a n 

I f y o u o rn x t t h e f i 1 e ri a rn ev t o t h e 1 e f t o f t h e e* c^ u a I s i g n , LIN 6 8 c r e a t e t h e 

output file using the first filename in the command line, and assigns the 

d e f a u 11 f i 1 e t y p e 6 8 K« F o r e x a rn p 1 e, t h e f o 11 o w i n g c o m m a n c:l c r e a t e s 81N - 6 8 K s 

1 a1 i n k 6 8 s i n „ c c:i s t a n 
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6* 1 a 2 LIN K 6 8 C a m m a n d - L i n 0 0 p t 1 o n s 


W h 0 n y 0 u :i. n v o k 0 i... 1 N !< 6 8 ,, y o u c ax n s p 0 c i t y c o rn m a n d -1 i n e 
t h 0 1 i n k o p 0 r a t i c:< n « T h 0 r 0 a r 0 t w o k i n d s o f o p tx o n s 3 
h 1 o b a 1 o p t :i. o n s ax p p 1 y 1 0 t h 0 e n t i r 0 I i n k o p 0 r a 1 1 o n » 


o p t i o n s t h a t c 0 n t r o I 
g 1 o b a 1 a n d 1 o c a i « 
L. o c: ax 1 o p t i 0 n s a p p I y 


on 1 y t a t he i nd i vi dua 1 f i 1 es bei ng I i n ked« Vou enc 1 ose g 1 oba 1 op t x ons :i n 
s q u a r 0 b r a c k e t s x rn rn 0 d x a 1 0 1 y pr 0 c 0 d i n g t h 0 0 la t p u t f i 1 e n a m 0 < i f s p 0 c i f i 0 d ) i n 
t h 0 c o m m a n d 1 1 n 0 « Y o u 0 n c 1 o s 0 1 o c a 1 o p t i o n s i n s q u a r e b r a c k 0 1 s x rn m ex d i a 1 0 1 y 


f 0 11 0 w x n g t h 0 f i 1 0 n a rn 0 i o w h x c: h t h 0 y a p p I y« 


Y o u c a n u s 0 s p a c 0 s b 0 1 w e 0 n f i 1 0 n a m e s t o 3. m p r o v 0 r 0 a d a b i 1 x t y i n 1 1 "! 0 co m m a n d 
i i n 0 , a i"! d y 0 la c a n p u t rn 0 r e t h a n 0 n 0 0 p t i 0 n x n s q la. ax r ex b r a c: k 0 1 s b y s e p a r a t i n g 
t h 0 m w i. t h c o m m a«. s« LIN K 6 8 a 1 s o a 11 0 w s y o u t o a b b r ea v i a. t ea a n o p t i o n n a m e t o 
x t s sh or t east un arnb i guous f or rn. Taxfo 1 0 6-1 1 x st s t h 0 LINK68 op t i on an d 

0 h p 1 ax.i ns thei r use- Ahbrevi ated forms i n parentheses- 


N 0 1 03 BE M D 0 8 r 0 q u i r e? li-i- t h a t t h 0 i 1 n k 0 d f i I 0 h ax v 0 t h 0 rn ax g i c n u m b ea r c:> 01A H „ 
LINK 6 8 prod lac es the output file with this magic number only when you 
r e? q la ea s t a r ea 1 o c a t ax h 1 0 f i 1 ea w x t h c: o n t i g u o u s t ea k t, d ax t ax,, ax n d b s s s 0 q m e? n t sa « 
C o n 0 «q u ea n 11 y , t o c r jo ax t e? a c o m m a n d f i 1 ea t o r' u n u n d ea r G E M D 0 8« d o n o t s 0 1 ea c t 
the ABSOLUTE, DATABASECn3, BSSBASECnJ, or TEXTBASECn3 options when you 
i n v o k e LIN K 6 8« 


T a b I e 6 1« L.. 1N K 6 3 C 0 m rn ax n d I i n ea 0 p t i 0 n s 

0 p t x o n F la n c t i o n 


ABSOLUTE < AB) 


Tel Is LINK6B to 
r ea 1 o c a t i o n !:::« 3 . t s - 
N o 1 0 t h a t c o rn m a n d 
GEN DOB« 


g ea r 10 r ax t e a n a b s 0 1 u t e^ f x 1 e w i t h n 0 
The default is a real oca tab 1 ea program, 
f 11 0 s rn la s t b ea r ea 1 0 c a t a b 1 e* 1 0 r u n u n d 0 r 


A L. L M 0 D S (A L) 7* ex 11 s L. IN K 6 8 t o 1 o a d a 11 m 0 d u 1 ea s f r 0 m ax 1 i b r a r y , 0 v 0 r"i i f 

t h e y ax r e n o t r ex t e r e n e: e d» T h e d e f a u 11 i s t o i n c: I u ci 0 o n 1 y 
t h o s 0 m 0 d u 1 0 s t h a t a r ex a c t u ax 11 y r 0 f ea r ea n c: 0 d „ 

BSSBASE] l n (B L n II) 

Sets the base addrexss for the uninitialized data segment 
(b s s > i n d i s c on 1 3 . g la o u s p r o g r a rn s. T h e n x s ax I"? e k a d eci m ax 1 
v ax 1 u ex « T h ea d 0 f a u 11 v ax I u ea i s t h ex f i r s t 0 v 0 rx w o r cl a f t ea r t h 0 
data segment. 
















Dpt i on 

COMMAND <C> 

DATABASE II n .3 

IGNORE (ID) 
INCLUDE <IN) 

LOCALS (L) 

NOLOCALS <NO 

symbols <s> 

TEMPFILESCds 


6 0 m D c::« s D o c: u m e n t a t i o n 
Serial Number 006738 


T a b I e 6 -1» (c o n 1 1 n u. e d) 


Function 


T e 11 s L1N K 6 3 t h a t t h e f o 11 o w i n g n a m e cl f :i. 1 e c o n t a i n s t h e 
r e s t o f t hi e c o m rn a n d 1 i n e« L... IN K 6 8 i g n o r e s t h e r e s t o f t h a 

m a i n c o m rn a n d 1 i n e« N e s t e d c o m m a n d f i 1 a s a r © n o t a 11 o w e cl« 

71 "! a f o r m a t o f t h i s o p t i o n i s s 

C 0 l Y ! l i A N D C f i I e n a m e 11 

w h a r e f i 1 e n a m e i s t h a til e c: o n t a i n i n g t h e r © s t o f t h e 

command 1ine« 

(D11 n 13) 

S p 0 c i f i © s 1h a b a s a a d d r © s s o f t h i a d a t a s © q m © n t i ri 

d i s c o n t i g u. o u s p r o g r a m s. 7 h © n i s a h e x a d e c i rn a 1 v a 1 u ©» 7 h a 

d a t a u 11 i s t h © f i r s t © v e n w o r d a f1 © r t h © t © x t. s e? q m e r 1 1« 

7 e 13. s LIN K 6 8 t o i g n o r © 16 ~ b i t a d d r e s s o v e r f 1 o w« 

T © 11 s LIN K 6 8 t d I d a d a n u n r © f © r © n c © d rn o d u 1 © f r o m a 1 i b r a r y * 

T h © f o r rn a t f o r t h i s o {31 i o n i s t h e f o 11 o w i n g w h e r e 

rn o d u 3. © - n a m © :i. s t h © m o d u 1 © y o u w a n t t o 1 o a d s 

f i 1 © n a m © I IIN C L U D E C m o d u 1 © - n a m © 2 II 


T © 11 s LIN K 6 8 t o p li t 1 o c a 1 s y rn b o 1 s i n t h e s y m b o 1 t a b I ©. T h © 

d © f a u 11 i s n o 3. o c a 1 s y m b o 1 s * L 0 C A L S o i“! I y a p p 1 i © s f r o m t h © 

p 0 i n t :i. n t h © c: o m rn a n cl 13. n © t hi a t i t a p p © a r s . 

7 h © N 0 L 0 C A L 8 o p t :i a n t u r n s t h i s o p t i a n a f f . U s © L 0 C A L 8 a n d 

N 0 L 0 C A L S i n c o m b i n a t i o n t o p u t 1 o c a 1 s y m b o 1 s f r o m s p © c: i f i c: 

•f i 1 © s i n t h © s y m b o 1 t a b 1 © „ LIN l< 6 8 a I w a y s i g n c:» r © s 1 cd c a I 
s y m b o I s s t a r t i n g w i t h 1.... 


) See LOCALS- 


T © 11 s LIN K 6 8 t d p u t t h © s y m b o i t a b 1 e i n t h © o u t p u t 111 © „ 

T h © d e f a u 11. i s n o s y m b o 1 t a b 1 © i n t h © o u t p u t t i I © - 


li (TEMCds li > 

Tel Is LINK68 
default is the 
TEMPF I LEE), i t 
i. i n ©« 


t d u s © d r i v © d f o r t © m p o r a r y f i 1 © s» T h b 
curren11 y 1 ogged••••• i n dr i vIf you us© 
rn u s t p r © c: © d b a n y i n p u t f i 1 © s o n t h © c o m m a n d 











6 e m D a s D o c u m e n t a t i o n 
S e r i a 1 N u m b e r 0067 38 


T a b I e 6 -1« < c o n t i n u e d) 


0 p t i o n F u n c t i o n 


T* E X T B A S E II n 3 (T E X I" n 3 ) 

S p e c :i f i e s t h e b a s e a d d r © b s f o r t h e t e x t b e g m e n t. T h © n i s 

a h e x a d e c i m a 1 v a 1 u e* T h e d e f a u 11 i s 0 H „ 

U N D E F' IN EE D (U) T 0 11 s LIN K 6 8 t o i q n o r © t h e p r 0 s 0 n c: 0 o f u n d 0 1 i n e d b y m b o 1 s i n 

t b © i n p u t f i 1 0 s « LIN K 6 8 1 i s t s t h e u n d 0 f i n 0 d s y rn b a 1 s , t h 0 n 

con t i nues pr ocessi ng« Th© d 01 au11 ac: t i on i s t o I i st any 

u n d 0 f i n 0 d s y rn b o I s , t li e n s t o p p r o c 0 s s i n g * 


The following are examples of LINK68 command lines- Addresses are in 
h 0 x a d 0 c i m a 1 « T h 0 f i r s t c o m m a n d 1 i n 0 0 x a m p 1 0 1 i n k s t h 0 f i X 0 s F 0 0 M AIN a n d 

F 0 0 LIB i n t o a c o rn m a n c:l f i 1 e n a m c* d F 0 0 B A Z , 11 a 1 s o 1 0 1 1 s LI N1< 6 8 t o i n c:: J. u c:l e 

t h 0 s y m b o 1 t a b 1 0 i n F 0 0 B A Z , a n d p 1 a c 0 t h 0 1 0 m p o r a r y f i 1 0 s o n d r i v 0 B * 

•L' a > 1 i n !•••: 6 t : 3 E 0 y m 1 0 rn L' b r, 3 3 f o o b a z - f a o rn a i n * f o o 1 i b 

T h 0 n 0 x t 0 x a rn p 1 0 1 0 11 s LIN K 6 8 t o r 0 a d t h 0 c o m rn a n cl 1 i n 0 t r o m t h 0 t i 1 e 

LIN K IT« IN P» N o t e t h a t c 1 o s i n g b r ax c k 0 1 0 a r 0 n o t n e 0 d e d. 

{ a > i i n k 68 [. c om L 1 i i" j k i. t« i n p 

1' h 0 f : i 1 0 L. IN KIT« 1N P rn i g h t c o n t a i n t h 0 f o 11 o w i n g c o rn m a n d s n 

•C a 5 1 i n k 6 8 C a b , 1 0 x II5 00 3 * d II2 a 00 3 , b 1 3000 3 3 s c r e 0 n «= 

sc r n b 1 II1 II n i o 1 i b II a 1 3 

T h i s cr. o m m a n d c r 0 a 1 0 s t l" i 0 f lie 8 C EE EE N t r o m t h 0 f i 1 0 s 8 C E N 81 a n d 101... IB« T h 0 

command tells LINK68 to create SCREEN as an absolute file with the text 

s 0 g m 0 ri t s t a r t i n g a t 50 0 H ? t h e d a t ax s 0 g rn e n t s t a^x r t i n g a-x t 2 A 0 0 H , a ri d t h 0 

1 n i t i a 1 i z 0 d d a t a s 0 g m 0 n t nr> t a r t i n g a t 30 00 H« 11 a 1 s o t e 11 s LIN K 6 8 t o 

i n c 1 u d e 1 o c ai 1 s y rn t:« o 1 s f r o m 8 C R N S1 ax n d a 11 t h 0 rn o cJ u 1 0 s i n 10 LIB» 


6.1.3 REDIRECTIMG DIAGNOSTIC OUTPUT 

N o r m a 1 1 y 9 L N K 6 8 0 n cl s ax 11 d i ax g n o s t i c c::* u t p u t t o t h 0 c: o n s o 1 0 „ FI o w 0 v e r ^ y o u 

can redirect this output by using the > character in the command line. For 
0 x a m p 1 0 , t h 0 f o 11 o w i n g c o rn rn ax n d c r ea a 1 0 s M V FI EE« 6 & K o n dr i v 0 A «, u s i n g d r i v 0 B 
f o r 11 "! e 1 0 rn p o r a r y f i 1 0 s, ax n d s 0 n d s t h 0 d i ax g n o s t i c s o u t p u t t o t h 0 f i 1 0 
L N K li S 6 E> „ T X T o n d r i v 0 D:: 

i ax > 1 i n k 6 8 II1 0 m C h s 3 rn y f i 1 0 . 6 8 k « rn o d a h m o d b > d 2 1 n k m s q s«t x t 
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6 a 2 L068 

i h e i...068 i i n k e r c o rn b i n e s A S 6 8 a s s e m b i e cl < o fo j e c t) p r o g r a rn s t o p r o d u c: e a 

r e 1 o c: a t a b 1 e c: o rn r n a n d f i 1 e« A1 1 e h t. e r n a 1 r e f e r e n c e s a r e r e s o 1 v e cl... 7 h e 

1 i n k e r m u s t b e u s e cl t o c: r e a t e e x e c u t a b I e p r o g r a rn s « { 0 v e n w h e n a s i n g 1 e 

object program contains no unresolved references. The argument routines 
a r e c o n c a 1 0 n a t e d 1 n t h 0 o r d 0 r s p 0 c i f i 0 d. T h 0 0 n t r y p o i n t o f t h 0 o u t p u t i s 

t h 0 t i r s t i n s t r u c t i o n o t t h 0 f i r" s t r o u t i n e» 

M o 1 0 a 6 E H D 0 S r 0 q u i r 0 s t h a t t h 0 1 i n k 0 d file h a v 0 t h 0 rn a g i c: n u. rn b e* r 6 01A hi« 

L .060 p r o d u c 0 s t h 0 a u t p u t f i 1 0 w 1 11 " ! t h i s rn a g i c n u m b 0 r o n 1 y w h 0 n y cd u r 0 q u 0 s t 

a r 0 1 o c a t a b 1 0 f i 1 0 w i t h c: o n t i g u o u s t e? k t ^ cl a t a , and b s s s 0 q m e? n t „ 

C o n s 0 q u 0 n 11 y ^ t c:« c: r 0 a 1 0 a e; o rn rn a n d f i 1 0 t o r u n u n d 0 r G E M D 0 8 n d o n o t s e? 1 0 c t 

t h 0 — T h .Z .D h . B „ a n cl - S o p t i o n s a n ci sole c: t t h ® — R o p t i c« n w h 0 n y o u i n v o k*: 0 

L068» 


A p p 0 n d 1 x D 1 i ci-1 s t h 0 e r r o r m 0 s s a g e s t h a t L...068 d i s p 1 a y s „ 


6.2« 1 I n v a k i n g L 0 6 8 

I n v o I*:: e^ L 0 d:> 8 b y 0 n 1 0 r i n g a c o rn m a n c:l c« f t h 0 f a 11 o w i n g f o r m« T a h 1 0 6 - 2 

d 0 s c r i b 0 hh- 11"! e o p t i o n s. 

L...068 II F p a t h n a m e^ II C ••• R J II - E> 3 H -13 II - U n a m 0 II 

II - 0 f i 1 0 n a rn 0 3 II ~~ X 3 II - Z a cl d r 0 s s 3 

LI D a d c j r 0 s s 3 C ••••• B a d d r 0 s s II 0 b. j 0 c: t f 11 0 n a m 0 l o b j 0 c: t f i 1 0 n a rn 0 3 

II > m 0 s s a g 0 f i 1 0 n a rn 0 J 









6 0 m D 0 s D o c: u rn e n t a t i o n 
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Fabi e 6-2«. L068 Opt i ons 

0 p t x o n M e a n i n g 

.F p a t h n a rn e S p e c i t i e s t h e p a t h n a rn e t o t h e d i r e c t a r y x n w h x c h t e m p o r a r y 

files a re crea ted. 

.R Pr 0 serves the re 1 oc:ation bi ts so the resu 11 inq e k 0 cutab 1 e 

p r o q r a m i s r e 3. o c a t a b 1 0 « 

•••*• S S t r x p s 0 u t p u t ( x f s p 0 c 1 f i e d) 5 t h 0 o u t fu. t 1 s s t r i p p 0 d 0 f 11 "! 0 

s y rn h 01 t a b 1 e a n d r 01 o c a t i o n b i t s« 

.I D o 0 s n 01 g 0 n 0 r a 10 16 - b x t a d d r 0 s s 0 v 0 r f1 0 w m 0 s s a q e s, W h e n 

y o u a s s 0 rn h 1 0 a p r o g r a rn w i t h 0 u t t h 0 A S 6 8 — L 0 p t x 0 n , t h e 

1 x n k 0 r rn x q h t g 0 n 0 r a 1 0 a d d r 0 0 s 0 v 0 r f 3. 0 w m 0 s s a g 0 s x f t hi 0 
p r 0 g r a m c: o n t a i n s a d d r 0 s s e s 1 o n g 0 r t h a n 16 hi t s« 

.U n a m ex F c::* r c ex s 1 i n k i n q 0 f a 1 x b r -a r y m 0 d u 1 0 t h a t r 0 0 01 v 0 s t h 0 n a rn 0 

parameter, even if the name is not referred to by any other 
rn 0 d u 1 0 b e 1 n g 1 i n k 0 d * N o r m a 11 y , lib r a r y rn 0 d u 1 es are 0 n 1 y 
3. x n k 0 d w h 0 n t h e-x y a r 0 n e e d 0 d t o r 0 s o 1 v 0 r 0 f 0 r 0 n c 0 s i n o t h ex r 
rn 0 du 1 ex s« V 0 u c:an us 0 thx s 0 p t i 0 n to cr 0 a 10 a pr 0 gr am f r 0 rn 
a 1 i b r a r y x f t h ex m o d u 1 0 res o 1 v i n g t h 0 n a m 0 p a r a rn 01 er ea 3 .1 s 
01 h ex r m o d u 1 0 s i n t h 0 1 x b r ax r y. 

- 0 f i 3. 0 n a m & G i v & s t h 0 a fc:« j 0 ct f i 1 e p r 0 d u c e d b y L068 t h 0 f x 1 e n a rn 0 t hi a t 

y 0 u s p e? c: x f y f 011 0 w x n g t h 0 - 0 0 p t x c:» n » T h 0 - 0 0 p t x 0 n ax n d 

f x 1 ename are separat ed by on 0 or rnor & spaces« I f you do 
n 01 s p e c 1 f y a f i 1 e n a m 0 , t h e 0 b j 0 c t f x 1 e h ax s t h 0 n ax m 0 C. 0 U T« 

.X I n c 1 u d e s aa 11 1 o c a 1 s y m b o 1 s i n t h 0 s y m b 0 1 t a b 1 e 0 k c 0 p t t h 0 s e* 

that b 0 gx n wxth th 0 1 etter L» If n 01 sp 0 cx fi 0 d, L068 puts 
only global symbols in the symbol table. This option 
a 11 0 w s y 0 u 10 d i s c: a r d c o m p i 1 0 r x n 10 r n a i 1 y g 0 n 0 r a 10 ci 1 a b 0 Sv 
t hi a t b 0 g x n w x t h t h 0 1 0110 r L w h x 1 0 r 01 a i n i n g s y rn b o 1 s 1 o c: a 1 
to routines. 

.Taddress* 

-Zaddress* 

T h 0 •■••• F a n d - Z o p t i 0 n s a r 0 e q u 1 v a 1 0 n t, T h 0 h e x a d 0 c 1 rn a 1 

a d d r 0 s s q x v 0 n i s ci e f x n 0 d !::«y L068 a s t h 0 b 0 g i n n i n g a d d r 0 s -s 

for the text segment. This address defaults to zero, or it 
c a n h 0 s p 0 c i f i 0 d a s a n y 0 v 0 n b & x a d 0 c i rn a 1 n u rn b 0 r b 01 w 0 0 n 0 
a n d F F F’ F- F F F’ F , T h i s 0 p t i 0 n i s u 0 f u. 1 f o r p u 1 1 i n g p r 0 g r a rn s 

i n R 0 M« H 0 x a d e c i m a 3. c h a r a c 10 r c a n b 0 x n u p p 0 r c a s 0 o r 

1 owercase. 
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T a b 1 e 6 - 2, < c o n t i n u e d) 

0 p t i o n li e a n i n g 

■ D a d d r e? ns s * T h e h e x a d e c i rn a I a d d r e s s q i v e n i s d e f i n e d b y L.068 a s t h e 

b e g i n n i n g a d d r e s s f o r t h e d a t a s e g m e n t« T h i ns a d d r e s s 
defaults to the next byte after the end of the text 
s e g m e n to r i t c a n b e s p e c i f i e d a s a n y e v e n h e x a d e c; i m a 1 
n u. rn b e r b etwee n 0 a n d F F F F F F F F« 7 h i s o p t i o n :i s e s p e c i a 11 y 

useful for for putting programs in ROM. Hexadecimal 
a d d r e s ns c h a r a c t e r s c a n b e i n u p p e r c a s e o r 1 o w e* r c a ns e« 

.B a d d r e s s * T h e h e x a d e e i m a 1 a d d r e s ns g i v e n i s d e f i n e d h y L068 a s t h e 

begi nni ng adclr ess f or t he bss« Thi s addr esns def au. 11ns to 
the next byte after the end of the data segment, or it can 
bEv- nspec: i f i. ed as any even hexadecimal number between 0 and 
FFFFFFFF- 

o b j e c: t f :l. 1 e n a m e I.'.' o b j e c: t f i 1 e n a m e* 11 

T I™! e n a m e o f o n e o r 
a ns s e m b 1 e r A S 6 8» T h e s e 
1 i n k ns« 

> iTi e ns s a g e f i 1 e n a m e 

I f nspec i f i ed , er r or rnessages pr oduc ed by L068 ar e 
r e d i r e c t e d t o t h e f i 1 e t h a t y o u ns p e c i f y i m m e d i a t e 1 y a f t e r 
t h e g r e a t e r — t h a n ns i q n < >) » I f y o u d o n o t ns p e c i f y a 

f i 1 e n a m e ? e r r o r m e s s a g e s a r e w r i 11 e n t o t h e s t a n d a r d 
d e f a u 11 o u t p u. t d e v i c e, w h i c h t y p i c:: a 11 y i s y o u r c o n nil- o 1 e 
termi nal« 


6« 2« 2 S a rn p 1 e C o m m a n cJ ns I n v o k i n g L... 0 6 8 

•C a > 1 o 6 8 — ns - o t e ns t „ 6 8 k t e ns t» o 

Th i ns command 1 i n ks a ns ns e mb 1 ed f i 1 e TEST« 0 i nto f i 1 e TEST' „ 68K and nst r i pns out 
t h e s y m b o 3. t a h 1 e a n ci r e 1 o c a t i o n b i t ns „ 

■i a > 1 o68 .14000 d 8000 .b c: 0 0 0 a« o b „ o c « o 

T h i ns c o m m a n d 1 i n k ns a s ns e m b 1 e d f i 1 e s A „ 0, B» 0 , a n d C „ 0 t o t h e d e f a u 11 o u t p u t 

f i 1 e C« 0 U T« T I" ! e t c? t ns e q rn e n t ns t a r t s a t 1 o c a 1 1 o n •'•I-00 0 H 5 t h e cl a t a s e g m e n t 

s t a r t ns a t 1 o c a t i c« n 8000H; a n d t l"i e h s s s t a r t ns a t 1 o c a t ion C000H. 

■C a > 1 o 6 8 i .o t e ns t. 6 8 k t e s t« o t e ns 11. o > e r r o r 

T l i 1 s c o rn m a n ci 1 i r? k ns a ns ns & m b 1 e d f i 1 e ns T E S T« 0 a n d T E S T 1 * 0 t o f i 1 e T E 8 ‘ T «, 6 8 K» 

A n y 16 •• b i t a ci cl r e? ns ns o v & r f 1 o w e r r o r ns a r e i g n o r e cl r t e? r r o r rn e ns ns a g e ns a r e ci 1 r e c:: t e d 

t o t |-i e f i 1 e E R R O E „ 


rn o r e o b. j e c t f i 1 e ns p r 0 ci u c: e ci b y t h e 
a r e t h e o b. j e c t f i 1 e ns *b h a t L 0 6 8 
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6.3 RELMOD FORMAT CONVERSION UTILITY 

LIN K 6 8 a n d L068 p r o d u c e f i I e s i n C P / M ~ 6 8 K r e 1 o e a t a b 1 e f o r m a t« U s e t h e 
R E L H 0 D c o m m a n c J t o t r a n s 1 a t e 1 i n k e r o u t p u t file f r a m CP / M - 6 8 K f o r m a t t o G E !i 
D 0 S r e I o c: a t a b 1 e t o r rn a L « 

T h e R E L M 0 D c: o m m a n d 1 i n e i s i n t h e f o 11 o w i n g f a r m s 

R E L. M 0 D i n p u. t f i 1 e o u t p u t f i 1 e 

w h e r e i n p u t f i 1 e i s t Y i e C- P / H—6 8 K f o r m a t f i I e p r o d u. e e d b y t h e 1 i n k e r a n d 
o u t p u. t file x s t h e n a m e f t. h e f i l e t r a n s 1 a t e d t o G E M D 0 S f o r m a t« 

RELMOD c an a 1 so b e used t o t r an s I at e GEM DOB f or mat f i 1 es b ac: k t o CP/ M-68K« 

Th i s i s done by si mp 1 y spec i f y i ng the GEM D08 f i 1 e as the i nput f i 1 e and 

t he C P/ M-• 6BK f i le as t he out p u t f i 1 e.. 


E n d o f S e e t i o n 6 
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ARCHIVE UTILITY 


/„1 INTRODUCTION 

The Ar ch :i. ve ut i 1 i t y „ AR68 n cr eat es a 1 i h r ar y or r ep 1 ac:es , adds ,, de I et es , 
]. x 151 s «, o r e h t r a c t s o b j e c t m o d u 1 e s x n a n e x i s t i n g 1 i b r a r y« A H 6 8 c: a n b e u s e d 
on the C Run-time Library distributed with GEN DOS and documented in the 
8 E li D 0 S S u p p I e m e n t t o t h e C L a n g u a g e P r a g r a m m e r " s G u i. d e f o r C P / M - 6 8 K« 


7 .. 2 A R 6 8 8 Y N T A X 

T o i n v o k e A R 6 8 , s p e c i f y t he c: o m p o n e n t s o f t h e t o i 1 o w i n q c o m m a n d I i n e * 
0 p t i o n a 1 c o m p o n e n t s a r e e n c 1 o s e d i n s q u a r e b r a c k e t s ( C 3 ) „ 

AR68 DRTWXl AV 3CF pathn ame3 L 0PM0D3ARCHIVE 
OBNOD1 1 OB MOD 2».. 3 l >fi1espec3 

Y o u c: a n s p e c i f y m u i t i p 1 e o b j e e t m o d u 1 e s i n a c o m m a n d 1 i n e p r o v i d e d t h e 
c o m rn a n (d i i }" i e d o e s n o t e h c e e d 12 7 Id y t e s« T h e d e 1 i. m i t e r c h a r a c t e r b e t w e e n 
c:: o rn p o n e n t s c: o n s x s t s o t o n e o r m o r e s p a c e s« 

T a b 1 e 7 -1 I i s t s a n d d e s c r i b e s 11*1 e c o m p c:« n e n t s o f t h e A R 6 8 c o m m a n d 1 i n e * 


I 
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Fable 7-1« AR68 Command Line Components 
C o m p o n e n t M e a n i n g 


A R 6 8 1 n v o k e s t h e A r c h i v e u t i 1 i t y. H o w e v e r „ i Y y o u s p e c i f y o n 1 y 

the AR68 command, AR68 returns the following command line 
s y n t a x a n d s y s t e m p r o rn p t« 

•[ a >ar 68 

usages AR68 DRTWX t AVII CF pathname] COPMQD] ARCH IVE 
OB MO I) 1 C OB MO 02 . ■ « ] C >f i 1 esp ec 1 

1 a ..*■ 


D H T W X I n d i c a t e s y o u. rn u. s t s p ec i f y o n e o f t h e s e 1 e 11 e r s a s a n A R 6 8 

c o m rn a n d « E a c h o f t h e s e o n e —1 e 11 e r c o rn rn a n d s a n ci i t s o p t i o n s 

a r e d e s o r i b e d i n E> e c: t i c::> n 7 « 4 „ 

A V 1 n d i c a t e s y o u. c a n s p e c i f y o n e o r h o t h o f t h e s e o n e—1 e 1t e r 

o p 11 o n s« F h e s e o p t i o n s a r e d e s c r i b e d w i t h t h e cr. o m m a n d s i n 

Section 7.4. 

F pathname 

8 p e c i f i e s t h e p a t h t o t h e d i r e c t o r y i n w h i c h t h e t e m p o r a r y 

f i 1 e created by AR68 res:i des« If no path name i 

spec i f i ed „ t he cur r en t def au 11 d i r ec t or y i s used» AR68 

c r e a t e s a t e m p o r a r y f i 1 e c a 11 e d A R 6 8 „ T M P t h a t A R 6 8 u s e s as 
a s c r a t c h p a d a r e a„ 

0 F' M 0 D I n d i c a t e s a n o b j e: c t m d u 1 e w i t h i r-} t h e lib r a r y t Fi a t y o li 

specify« The 0PM0D parameter indicates the position in 
w h i c h a c:! d i t i o n a 1 o b j c: t m o d u 1 e s res i d e w h e n y o u i n c: o r p o r a t e 
m CD d u 1 e s i n t h e 1 i b r a r y a n d s p e c: i f y t h e A o p t i cd n « 

A R C HIV E P" i 1 e s p e c i f i c: a t i o n o f t h e 1 i b r a r y „ 

0BM0D1 C0BM0D2 «.« ] 

In dicat es one or mor e obj ect modu1es in a 1ibr ary t h at AR68 
d e 1 e t e s , a d d s «» r e p 1 a c e s , o r e x t r a c t s» 

> f i 1 e s p e c R e d i r e c:: t t h e o u t p u t t o t h e i i 1 e s p e c i f i c: a t i o n y c::« u s p e c i f y , 

r a t h e r t h a n s e n d i n q t h e o u t p u. t t o t h e s t a n ci a r d o u t p u t 

d e v i c h w h i c h i s u s u ax 11 y t h e c cd n s cd 1 e d e v i c e < C 0 N S 0 L E) « Y o u 

c a n r e d i r e c t t h e cd li t p u t f o r a n y o f t h e A R 6 8 c cd m m a n ci s 

d e s c r i b e ci i n S e c:: t i o n 7« 4 » 
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7.3 AR 68 OPERATION 

A E 6 8 s 0 c.i u 0 n t i a 11 y p a r s e s t h 0 c: o m rn a n d I i r1 e o n c: 0 „ A R 6 8 s e a r c h 0 s f o r • H 
x n s 0 r t s „ r 0 p 1 a c 0 s h q r d 0 1 0t e s o h j 0 c t rn o d u 1 0 s :t n t h 0 1 i b r a r y i n 11 "! 0 s 0 q u 0 n c 0 
1 n w h i c h y o u s p e? c; 1f y t h e m x n t h e c o rn m a n d 1 i n 0» S 0 c t i o n 7 » 4 d 0 s c: r i b 0 s 0 a c: h 

a t t h 0 c o m m a n d s A R 6 8 s u p p o r t s« 

W h 0 n A R 6 8 p r o c 0 s s 0 s a c o rn rn a n cix t c r 0 a 1 0 0 a 1 0 rn p o r a r y t i I 0 c a I 1 0 d A R 6 8 . T ii P H 
w h x c h i. t u s e s a s a s c r a t c: h p a d« A f t er t h 0 o p e r a t i o n i s c: o m p 1 e 1 0 A R 6 8 
0 r a s 0 s A E 6 8 . T Ii P. H o w 0 v 0 r A R 6 &« T M P i s n o t a I w a y s © r a s 0 d i f a n 0 r r o r 
o c c u r s» I f t h .i s o c c: u r s „ 0 r a s e A R 6 8 « T Ii P w i t h t h 0 E R A c o rn m a n d a n d r 0 f 0 r t a 

A p p 0 n cl i x D t cj r 0 r r d r m 0 s s a g 0 s o u t p u t b y A R 6 8 . 

7.4 AR 68 COMMANDS AND OPTIONS 

T h x s 0 c t i o n cl 0 iia- c r x b 0 s A R 6 8 c: o rn rn a ri d s a n d t hi 0 i r o p t x cd n s. E a rn p 1 0 s 

i ]. 1 u s t r a 1 0 t h 0 0 f f 0 c t a n ci i. n 1 0 r a c t x o n b 0 1 w e 0 n 0 a c In c o m m a n d a n d t h 0 a p t i o n s 

xt supports. 


7» 4. 1 T h 0 D C a m m a n d 


T h 0 D c: o rn m a n c:l d 01 010 s f r c::« m t h 0 1 x b r a r y o n 0 c:« r m o r 0 o h j e c t rn c;> c:l u 1 0 0 s p 0 c: i f i e cl 

i n t h 0 c: cd m rn a n d . T h 0 D c: o m m a n d s u p p o r t s t h e f o 11 o w .i. n g o p t i c:> n )! 

v L i s t s t h 0 rn o d u 1 0 s x n t h 0 i i b r a r y a n cl x n i c: a 10 s n h x c: h 

rn o d u 1 0 s a r 0 r 01 a i n 0 d a n d cl 01 010 ci b y t h 0 D c o m rn a n ci. T I" ! 0 V 

o p t i o n p r 0 c: 0 cl 0 s rn o d u 1 0 s re t a i n & ci x n t h 0 1 x t.) r a r y w x t h t h 0 

1 o w 0 r c a s 0 I 0110 r c a n d m o d u 10 s ci 01 010 d f r o rn t h 0 I x b r a r y 

w i t h t. h 0 I o w 0 r c: a s 0 I 0110 r d a s f c::« 11 o w s s 

•i. a > a r 6 8 d v rn y r a h . a r c o r c« a 

c red.o 
c: bl ue. a 
d ore: « o 
c: whit0.0 

■(. a J* 

T h 0 D c: o m rn a n d ci e? 1 010 s t l" i 0 rri o d u 1 0 0 R. C « 0 f r o rn t h 0 I i b r a r y 
N Y R A H. A R C« I n a d ci x t i o n t o I i s t i n g t h 0 m a d u I 0 s x n t h 0 
i x b r a r y h t h 0 V o p i x c:« n i n cl x c a 10 s w h i c h i m o d u. I 0 s a r 0 r 01 a i n 0 d 
and deleted« 
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7« 4« 2 T hi e R C o rn m a n d 

T h © R c o m m a n ci c: r 0 a 1 0 0 a 1 i b r a r y w h 0 n t h 0 o n 0 s p 0 c i f1 0 d i n t h 0 c o m rn a n d 1 i n 0 
d o e s n o t 0 x i s t,, a r r 0 p 1 a c: 0 s o r a d d s o b j 0 c: t rn o d u. 1 0 s t o a n 0 x 1 s t i n g 1 i h r a r y« 
v o u m u s t s p 0 c i f y o n 0 o r rn o r 0 o b j 0 c:: t rn o d u 1 0 s u 

You can replace more than one object module in the library by specifying 
t h 0 rn o d u 1 0 n a rn 0 s i n t h 0 c o rn rn a n d 1 i n 0 „ h i o w 0 v 0 r , w h 0 n t h e 1 i b r a r y c o n t a i n s 
two or mor 0 modu1es with the same nam©, AR68 rep1aces on1y the first modu1e 
1 1 f i n ci s t h a t rn a t c h 0 s t h e o n 0 s p 0 c 1 f i 0 d i n t h 0 c o m rn a n d 1 i n 0 « A R 6 8 r €5 p 1 a c 0 s 
rnodu 1 0 s a 1 r 0 ady i n the 1 i hr ar y on 1 y i f you sp 0 ci f y their nam 0 s pr i or to the 
n a m 0 s q f ri 0 w rn o d u 1 0 s t o b e a d d 0 d t o t h 0 1 i b r a r y * F o r e x a m p 1 0 if y ou 
specify the name of a module you. want replaced after the name of a module 
y 0 u a r 0 a c:! d 1 n g t o t h 0 1 i b r a r yA R 6 8 a ci d s b o t h rn o d u 1 e s t o t hi 0 0 n d o f t h 0 
1ibrary„ 

B y d 0 f a u 11 t h 0 R c o rn rn a n ci a d d s n 0 w m o ci u 1 0 s t o t hi 0 0 n ci o f t hi 0 1 i fc:> r a r y „ T h 0 

R c: o i n m a n d a ci d s a n o b j e c t m o cl u 1 e t o a 1 i b r a r y i f s 

•* T*hi 0 ob j ec t modu 1 e d 00 s not a 1 r eady ex i st i n t hie 1 i br ar y „ 

* Y o u s p e c i f y t hi e A o p 1 1 o n i n t h e c o m m a n ci 1 1 n 0 „ 

* The name of the module follows the name of a module that does not 
a 1 r e a d y e x i s t i n t h e 1 1 b r a r y « 

T hi 0 A o p t i o n i n ci i c: a t e s w h e r e A R 6 £< a c:l ci s m c:> ci u l 0 s t o t hi 0 1 i b r a r y „ Y o u s p 0 c: i f y 
t h e r e 1 a t i v e p o s i t i o n b y i n c 1 u ci i n g t h e 0 P M 0 D p a r a m e t er w 1 1 h t h 0 A o p 1 1 a n „ 

T hi 0 R c o rn m a n d a 1 s o s u p p o r t s t h 0 V o p t i o n w h i c: h 1 i s t s t hi 0 rn o d u 1 0 s i n t hi e 
1 i b r a r y a n d i n d i c: a t e s t h e r 0 s u 1 1 o f t h e o jo e r a t i o n p e r f o r m e d o n t i"i 0 1 i b r a r y« 
B o t h t hi 0 A a n ci V c::« p t i o n s a r 0 ci 0 s c r i b 0 ci b 0 1 o w» 
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Ihe r option adds one or more object modules tallowing the 
m o d u 1 e s p e c: i t 1 e d i n t h e c o m rn a n d 1 i n e s 


ia>ar 68 r a v sd av.o myr ah«ar c work. o mail«o 
c: much „ o 
c: sclav. o 
a wor k » o 
a mai 1 . o 
c iess.o 

T h e R A V c o m m a n cl a cl d s t h e o h j e c t m o d u 1 e s W 0 R K« 0 a n d M AIL« 0 
a f t e r t h e m o d u 1 e S D A V „ □ i n t h e 1 i b r a r y M V R A H * A R C« T h e V 
o p t i o n ? d e s c r i b e d b e 1 o w , 1 i s t s a 11 t h e rn o cl u 1 e s i n t h e 
1 i h r a r y« N e w m o d u 1 e s a r e p r e c e d e d b y t h e 1 o w e r c: a s e 1 e 11 e r 
a a n d e m i s t i n q rn o d u 1 e s a r e p r e c e d e cl b y t h e 1 o w e r c a s e 1 e 11 e r 

C a 

I' h e V o p t :i. o n 1 i s t s t h e o b j e c: t m a d u 1 e s t h a t t h e R c: o m m a n d 

r e p 1 a c e s o r a d d s« 

t a > a r 6 8 r v j n n k«rn a n n a i J. « o w r e n c hi«o 
c saw. cj 
c ham. o 
r n a i 1 « o 
c screw.o 
a wrench«o 


1 a J* 

T h e f : < c: o m rn a n cl r e p 1 a c: e s t h e o b j e c t rr i c::» d u 1 e N AIL. 0 ax n cl a cl cl s 
the module WRENCH.0 to the library JNNK.MAN. The V option 
J. i mi. t © o b j © c t m o d u 1 e s i n t h i e 1 i b r a r y a n d i n d i c: a t e © w h i c h 
m o d u 1 e s a r e r e p 1 a c: e d o r a d d e d « E a c h o b j e c t rn o d u 1 e t h a t i s 
r e p 1 a cad i s p r e c:: e d e d w i t hi t h e I o w e r c a s e J. e 11 e r r ax n d e a c lx 
o n e t h a t i © a d d e d i. © p r e c e e d w i t h t h e 1 o w e r c a s e 1 e 11 e r a« 
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7» 4 „ 3 1 h e T C o rn m a n d 

The T command requests that AE68 print a table of contents or a list of 
s p e e i f i e d m o d u 1 e s i n t h e 1 i b r a r y« T h e T c o rn m a n d p r :i. n t s a t a b 1 e o f c o n t e n t s 
o f a X 1 rn o d u. 1 e s i n t hi e 1 i b r a r y o n 1 y w h e n y o u d o n o t s p e c i f y n a rn e s o f o h j e c t 
rn o d u 1 e s i n th e c o m m a n d 1 i n e« 11 s u p p o r t s t h e f o X 1 o w i n g p t i o n . 

V T h e V o p t i o n d i s p 1 a y s t hi e s i z e o f e a c h f :i. 1 e i n t h e t a b 1 e o f 

c o n t e n t s a s s h a w n i n t h e f o 11 o w i n g e x a m p 1 e« 


•La > ar68 t 

v w i n e « 

bad 


rw-rw-rw- 

• 0 / 0 

6818 

rose.o 

rw“rw-rw- 

0 / 0 

2348 

whit e« o 

rw-rw-rw- 

■ 0/0 

396 

red n o 


•Ca> 

T h e T c o rn rn a n d p r i n t s a t a b 1 e o f c: o n t e n t s i n t h e 1 i b r a r y 
WIM E n B A D« I n a d d i t i o n t o 1 i s t i n g t h e m o d u 1 e s :i. n t h e 
1 i b r a r y «> t h e V o p t i o n r e q u e s t s 1 h e s i z e o f e a e: hi m o d u 1 e« 
The character str ing rw-rw-rw- 0/0 that precedes the module 
s i z e i s mean i n g 1 ess f or 6EM 008« However „ i f t h e f i 1 © i s 
transferred to a UNIX.... system, the character string 
d e n o t e s t h e f i 1 e p r o t e c t i o n a n cl t i 1 e o w n e r „ T h e s i z e 
s p © c i tied b y t h e d e c i m a 1 n u rn b © r t h a t p r e c © d e s t h e o b j e c t 
rn o ci u 1 e n a rn e i n d i c a t e s t h e n u rn h e r o f b y t © s i n t h e rn o cl u 1 e. 


?'« 4„ 4 T h e W C o rn m a n d 

The W command writes a copy of an object module in the library to the 
> f 1 1 e is p e c p a r a rn e t e r s p e c i f i e ci i n t h e c o m m a n d 1 i n e „ T h i s c: o rn rn a n d a 11 o w s y o u 

t o e x t r a c t a c o p y o f a rn o ci u 1 e f r o rn a 1 i b r a r y ax n cl r e n a m e? t h e c o p y w h e n y o u 

w r i t e i t t o a n o t h e r cl i. s k , a s s h o w n b e 1 o wF o r t h i s c o rn m a n d ? t h e > f .i 1 e s p e e 

p a r a m © t e r i s> r e q u i r e cl« 

•C a > a r 6 8 w g o« a r c n o w„ o > b s \ r o o t \ n e w d \ file, o 

The W command wr i tes a copy of t he ob j ec t modu 1 © NOW „ 0 f r orn t h© 1 i hr ar y 

80.: ARC to the file FILE.Q in the NEWD subdirectory on drive B« 


7« 4 n 5 T h e X C o m m a n d 

T h © X c: o m m a n d e x t r a c t s:- a c: o p y o f o n e o r m c:< r e o b j e c t rn o cl u 1 e s f r o m a 1 i b r a r y 

a n cl w r i t e s t h e rn t o t hi e d e f a u 11 d .i s k » I f n o o b j e c t rn o d u 1 e s a r e s p e c i f i e d i n 

t h © c o rn rn a n ci 1 i n e h t h e X c: o m m a n d e k t r a c: t s a c o p y c:« f © a c h m o cl u 1 e 1 n t h e 

1ibrary« The X command supports the fol1owing option« 

V The V option lists only those modules the X command 

e x t r a c t s f r o m t h e 1 i h r a r y« 11 p r e c © d e s © a c h e x t r a c: t e d 

m o d u 1 e w i 11) t h e 1 o w e r case 1 e 11 e r x a s f o J. 1 o w s s 

i a > a r 6 8 x v . j n n k » rn a n s a w« o h a rn« o s> c r e w. o 
x saw.o 
x ham., o 
x screw.o 
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7-5 AR68 ERRORS 

W h 0 n A R 6 &< i n c u r s a n e r r o r d u r i n q a n o p 0 r a t i o n , t h 0 0 p e r a t i o n i 0 n o t 
completed- The original library is not modified if the operation would 
h a v 0 m o d i t i 0 d t h 0 1 i b r a r y« T h u s, n o m o d u. 1 0 s i n t h 0 1 i b r a r y a r 0 d e 1 0 1 e d , 

r 0 p 1 aced ,, added or 0 x tr ac 1 0 d * R 0 f er to Append i. x D f or 0 r r or messages 

o u. t p u t b y A R 6 B - 

Is! h 0 n y o u s p 0 c i f y t h 0 > f i 1 0 s p 0 c p a r a m 0 1 0 r i n t h 0 c o rn m a n d 1 i n 0 t o r 0 d i r 0 c t 
the output and one or more errors occur, the error messages are sent to the 
o u t p u t f i 1 0 „ I' h u s h y o u c a n n o t d 0 1 0 c t t h 0 0 r r o r s w 1 1 h o u t d 1 s p 1 a y i n g o r 

p r i n t i n g t h 0 f i 1 e t o w h i c h t hi e o u t p u t w a s s 0 n t« 1 f t h e c. o n 1 0 n t s o f t h 0 

o u t p u t f i 1 0 1 s a n o b j 0 c t f 1 1 0 (s 0 0 t h 0 W c o rn m a n d) , y o u m u s t u s 0 t h e? E> U h i P 

uti1ity described in Sec1 1 on 8 to read any error messages- 


L : . : I n c J o i 5 0 c t i o n 7 
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MORE PR06RAMMING LJTILITIES 


8.I INTRODUCTION 

Thi s sect i on descri bes the DUMP81 ZE68 ,, SENDC68 H and XREF’ programmi ng 
utilities* DUMP displays the cent cents of -files in hexadecimal and ASCII 
n ot at i on. 81 Z E68 d i ©p I ay s t h e t ot a 1 size of a rnemor y i maq e c: omman d file 

a n c:l t h e s i z e o f e a c h o f i t s p r o g r a m © e g m e n t s« X R E F p r a d u c e s a c r a s © 
r e f e r e n c e s y rn b o 1 t a b 1 e f o r 6 E M D 0 S o h j e c t f i 1 e s« S E N D C 6 E) creates a f i I e o f 
Motoro1 a S~record© fram a command fi1e * (Refer to Appendix E f or a 

d e t a i 1 e d d e © e rip t i o n o f t h e S - r e c o r d f o r rn a t * ) 


8*2 DUMP UTILITY 

T h e D U M P u. t i I i t y < D U M P) d i s p I a y s t h e c o n t e n t © o f a 6 E M D 0 E3 f i I e i n b o t h 

h e x a d e c i rn a 1 a n d A 8 C11 n o t a t i o n « Y o u c a n u s e D11M P t o d i s p 1 a y a n y G E M D 0 S 

f i I e r e g a r d 1 e © © o f t h e f o r rn a t o f i t s c o n t e n t © < b i n a r y d a t a, A S C11 t e x t ^ a n 

e x e c u t a b 1 e f i I e) « 


8 * 2 * 1 I n v o k i n g D U M P 

I n v o k e D U l v ! P b y e n t e r i n g a c o m rn a n d w i t h t h e f o 11 o w i n g i n p u t c: o m p o n e n t s i n 

t h e -f o 11 co w i n g f o r m a t s 

D U M P II .© x k h x II f i 1 e n a m e 1 II > f i I e n a m e 2 II 

T a b 1 e 8 ~~1 1 i. s t s t h e D U M P c o m m a n d 1 i n e c o rn p o n e n t s a n d t h e i r rn e a n i n g s« 


T a b j. e 8 -1« D U M P C o rn m a n d L i n e C o m p o n e n t © 


C o m p o n e n t M e a n i n g 


s x x x x x x x x i s a n o p t i o n a I o f f © e t < i n h e x a d e c i m a 1 ) i n t o t h e f i I e * 

I f s p e c i f i e d 5 B l J M P s t a r t s d u m p i. n g t h e c o n t e n t © o f t h e f i 1 e 

f r o m t h e b y t e.o f f © e t x x x x a n d c o n t i n u. e © u n t i 1 i t d i s p 1 a y s 

t he cont en t s of t he en t i r e file- By def au 11, DUMP 1 st ar t © 
d u rn p i n g t h e c o n t e n t s o f t h e f i 1 e f r o rn t hi e beg i n n i n g o f t h e 
f i I e u n t i 1 i t d u. rn p s t h e c o n t e n t s o f t h e e n t i r e f i 1 e * 

f i J. e n a m e 1 N a m e o f t h e f i I e y o u w a n t t o d u m p * 

>fi1ename2 

1 h e g r e a t e r t h a n s i g n < >) f o 11 o w e d b y a f i 1 e n a m e o r 1 o g i c a 1 

d e v i c e o p t i o n a 11 y r e d i r e c t s t h e o u t p u t o f D U j i P * Y o u c a n 

s p e e i f y a n y v a 1 i d G El M D 0 8 © p e c i f i c a t i o n o r o n e o f t hi e 

1 o g i c a 1 d e v i c e n a m e s , C 0 N s < c o n s o 1 e > o r L. S1 s (1 :i. s t cl e v i c e) « 

I f y o u d o n o t s p e c: i f y t h i s o p t i o n ax 1 p ax r a rn e t e r , D U M F* © e n d s 
i t s o u t p u t t q t h e c o n s o I e« 
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8.2„2 DUMP Output 

D U M P s e n d s i t s o u. t p u t t o t h e c o n s o 1 e (a r t o a f i 1 e o r d e v i c e , i f 

s p e e i f i e d ) , 8 w o r d s p e r 1 i n e , i ri t h e f o 11 a w i n g f q r m a t s 

r r r r o o (f t f111) s h hi h I*"! h h h h h h i hi h h h h h h h h h h h h h hi hi h h h h hi hi 

* a a a a a a a a a a a a a a a a * 

F h e c: d m p o n e n t s o f a D U ii P c o m m a n d .1 1 n e a r e a s t o I i o w s s 
C o rn p o n e n t M e a n i n g 


r r r r 


00 


f f f f f f 


hhhh 


a a a. a*, a. a. a a 


Record number <8EI V ! DOB records are? 128 bytes) of the 
c u r r e n t 1 i n e o f t h e d i s p X a y» 


0 f f s e t < i ri h e x b y t e s) *f r 0 rn 

record« 

Cl -f t s e t ( i n h e x b y t e s) f r 0 m t h e 

C o n t e n t s 0 f t h e t i 1 e d 3 . s p 1 a y e d 

C cj n t e n t s 01 t hi e t i 1 e d i s p 1 a y e d 
c hi a r a c t e r i s n o t r e p r 0 s e n t a b 1 e 
a per led 


t h © b e g i n n i n g 0 f t h e 8 E M D 0 S 

b E?? g 1 n n 1 n g o t t h i b 111 e« 

i n hex adec i rna 1 « 

a s A 8 C11 c h a r a c t e r s» I f : a. n y 
in ABC11„ 11 is disp1 ayed as 


8 .2.3 DUMP ExampXes 

In the following example, DUMP is invoked to display the contents of a 
c 0 m m a n d f i X 0 t h a t c 0 n t a i n s d a t a i n b o t hi h i n a r y a n d A 8 C X X f q r m, 


•i.' a > d u. rn p d u rn p .. 6 8 k 


UiJijiJ 

* « « = 

00 
. 4 a 

<OOOOOO)s 

n m a *»*'"'* u * 

601 a 

0000 

lb 34 

0000 

011 cl 

0000 

0©5© 

0000 


0000 

* « » « « 

10 

< 000010)i 

4C * 

0000 

0000 

0000 

0000 

0900 

f ff t 

6034 

4320 


0000 
t i me 

20 <000020)s 

Copyr i. ght* 

5275 

6e74 

696d 

6520 

436f 

7079 

7269 

676E^ 

*Eun 

0000 

1982 

30 

by 

(00O03O)s 

Digita* 

7420 

3139 

3832 

2062 

7920 

4469 

6769 

7461 

*t 

0000 40 
Research 

(000040)s 

VO 1» 0* 

6 c 20 

5265 

7365 

6172 

6368 

2056 

3031 

2 c 30 

* 1 

0000 

0 . , 

50 
. « & 

(000050) r, 

I Sh.. * * 

3320 

206f 

0004 

2268 

0018 

2649 

cl3e8 

001 c 

*3 


(and so on) 
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8.3 81ZE68 UTIL11V 

T h e SI Z E 6 8 u. t i 1 i t y < 81 Z E 6 8 > i n d i c a t e s i f t h e? p r o g r a m s e g m e n t s w i t h i n o n e o r 
rn o r e c a m m a n d f i 3. e s a r e c o n t i g la o u. s a r n o n - c o n t i g u o u s 9 d i s p 1 a y s t h e s i z e o f 
0 a c h i p r o g r a m s e g m & n t a n d t h e s y m b o 1 t a b 1 e, a n d r e? p o r t s i f 11*"! e c o m rn a n d f i 1 e s 

ar 0 r e 1 ocatab 1 0 or non.r e 1 ocatab 1 0 ... 81 ZIE68 d i sp 1 ays both dec 1 ma 1 and 

h © k a d 0 c :l. m a 1 v a I u e s f >0 r t h 0 s :l. z 0 s o f t h 0 p r o g r a m s 0 g m 0 n t s a n d t h © s y m b o I 
table* GEM DOS command files usually have a filetype of „ PEG or «REL» The 
1 o t a 1 s i z e o f a c o m rn a n d f i 1 e ' s s 0 g m 0 n t s r e t u r n 0 d b y 91 Z E 6 8 a n d 11”! 0 0 i z 0 o f 
a c c:« m m a n d f i 1 0 r 0 t u r n 0 d b y t h 0 DIR c o m m a n d a r 0 n o t 0 q u a I « T I ”! 0 file s i z 0 
r 0 1 u. r n 0 d b y 81 Z E 6 8 i n c 1 u d 0 s t h 0 s 1 z e o f t h 0 1 0 >t t 9 d a t a a n d b s s p r o g r a m 
s 0 g m e n t s a n d t h 0 s i z e o f t h 0 s y m to o 3. t a fo 1 0 b u t d a 0 s n o t i n c 1 u d 0 11 "! 0 s i z 0 o f 
t h 0 h 0 a d 0 r a n d a n d r 0 1 o c a t i o n b i t s. F r o r rn o r 0 cl 0 1 a i I 0 o n t hi e DIR c o rn m a n cl, 
r 0 f 0 r t o t h 0 G E M D 0 8 U s 0 r s G u i d 0 « 


8« 3«, 1 I n v o k i n g 81 Z El 6 8 

I n v o k 0 E> I Z E 6 8 b y 0 n 1 0 r i n g a c o m rn a n d 1 i n 0 w i t h t h 0 f o 11 o w i n g f o r m a t s 

E> I ZE68 f i I enarne L f i 1 ©name2 f i 1 ©name3 9 « » * .3 t >out f i 1 0 2 

T h 0 81Z E 6 8 c o m rn a n cl 1 i n 0 c o rn p o n 0 n t s h a v 0 t h 0 f o 11 o w i n g rri 0 a n i n g s 


C o rn p o n 0 n t M 0 a n i n g 

f i 1 0 ri a m 0 F i 1 0 s p 0 c 1 f i c a t i o n o f a f i. 1 0 im h o s- 0 size y o u w a n t t c:) 

determine« 

fi1ename2 
fi1enam©3 » «« . 


0 ri 0 o r rn o r 0 a d d i t i o n a 1 f i 1 0 s p 0 c i f i c a t i o n s o f f i 1 0 s w hi o s e^ 
s i z s y o u w a n t t a cl 0 1 0 r m i n 0 « 81Z E 6 8 c a n p r o c 0 s s m u. 11 i. p 1 0 
f i 1 0 s 9 p r o v i d 0 d t h 0 c: o m rn a n d 1 i n 0 c:l c::« 0 s n o t »e k c:: 0 0 d 12 E* b y 1 0 s« 
N o 1 0 t h a t SI Z E 6 8 a X s o a c c: 0 p t s w i 1 cl c a r <:3 f i 1 0 s p 0 c i f i c a t i o n s« 

> o u t file 3 p 0 c :i. f i 0 s 11" ! 0 f i 1 0 s p 0 c i f 1 c a t i o n t o w h i c: h S11 LE 6 B s 0 n d s i t s 

c:> u. t p u t« I f v o u d o n o t s p 0 c i f y a n o u t p la t f i 1 0 

s p 0 c: i f i c: a t i o n 9 81Z E.‘ 6 8 s 0 ri d 112 . t h 0 o u t p u t t o t h e^ c: o n s c::» I 0 « F o r 
the output f i 1 0 spec 1 f i cat 1 on , you. can spec i f y a val 1 d GEM 
DOB filename, or one of the logical device names, CONs 
< c o n s o 1 0 > o r L S T« (I i ■:» t d 0 v i. c 0 ) „ 
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8. 3» 2 SI Z E 6 8 E x a m p 1 0 s a n d 0 u t p u t 

Thi s section c on t ains t wo examples 
output * 

i. Th 0 fo11owing S1 IE63 command line 0 : 
p r o g r a m s 0 g m 0 n t s i n o n 0 c o rn m a n d f i 1 

•Ca>SI ZE68 81 ZE68, PRO 
SIZE68„PRGs 

Conti gu.ous 

■ text length " :n 

■ data length = 

.bss length - u: 

S y m b o 1 t a b 1 0 1 e n g t h « 

S t a r t o f «t e x t = 

Fi 1 e is r 0 3. ocatab 1 e. 

SI Z E 6 8. P R 6 c o n t a i n s a 9 312 • b y t e 
(d e c i rn a 1 ) d a t a s 0 g rn 0 n t, a n d a 914 0 - 
c o n t i g u 0 u s a n c:l 81 Z E 6 8 i s r c* 1 o c a 1 
d 0 c i m a 1 v a 3. u 0 s a r e d i s p 3. a y 0 d i n t h c 


t h a t s h o w SI Z E 6 8 c: o rn m a n d 1 i n e s a n d 

a rn p 1 0 r 0 1 u r n s i n f o r m a t i o n a b o u t t h 0 




9312 

2 4 8 O 

1178 

49 A 

9140 

23B4 

0 

0 


0 0 


(dec i rn a 1 ) t e x t s 0 g m 0 n t, a 11 7 9 •••- b y 1 0 
b y 1 0 (d 0 c :l rn a 1 > b s s; t h e s 0 g rn 0 n t s a r 0 
a b I 0 a hi 0 x a d 0 c i m a 1 n o t a t i o n s f 0 r t h 0 
- 1 a s t c o 3. u m n o f SI Z E 6 8 o u t p u t. 


I hi 0 f o 11 c« w i n g 81Z E 6 8 c: o m rn a n d 1 i n 0 u s e s a\ w i 1 d c: a r d f i 1 0 s p 0 c: f i c:: a t i 0 n t o 
r 0 1 ur n i n f or mat i on can an ob j ec t file, a c: omman d f i 1 ea, an d a t ex t file* 

C a } 81 Z E6B FI *« 

FIND.Os 

Conti gu.ous 


»text 1ength 


m: 

1072 

430 

„data Iength 



188 

BC 

„bss Iength 



0 

0 

8 y b 0 1 t a b 1 0 

1ength 

~r. 

1708 

6 AC 

Start of »te> 

c t 


0 

0 


F i 1 0 i s r 0 1 o c a t a b 1 0 « 

FIND.PRGs 

Conti gu.ous 


«text 1ength 

n::: 

9888 

2 6 A0 

„ data 3. ength 

:nr. 

1060 

424 

«bss 1ength 

:::u 

9396 

24B4 

S y rn b 0 1 t a b i. 0 1 0 n g t h 

n:r 

0 

0 

Start of .text 

i ::: i 1 0 i s r 0 1 0 c: a t a b 1 0 « 

nn: 

0 

0 


FILE» MSG? s 

N o 1 a p r o g r a m f i 1 0 « 

N o t i c t h a t w h 0 n y o u s p 0 c i t y a t i 1 0 t h a t i si- n o t a c: o rn m a n d t i 1 0 
(FILE.MSG 9 an ASCII file, for example) , SIZE68 displayss 

N o t a p r o g r a m f 3. 1 0« 


When you specify an absolute program file whose segments are non-contiguous 
i n a SI Z E 6 8 c a m m a n d 1 ine, SI Z E 6 8 i n c 1 u d 0 s t h 0 f o 3.1 o w i n g rn 0 s s> a g 0 s i n i t is 
out puts 


N o n - c CD n 1 1 g u o u s 


N o r 0 1 o c a t i o n i n f o r rn a t i o n i n f i 1 0 
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8* 4 SENDC68 UTILITV 


8 E N D C 6 8 c r e a t e s a f i 1 e w i t h M o t o r o i a S ••••• r e c o r d f o r m a t f r o m a n a b s o 1 u t e 


command file* S~‘records are a way to represent an absolute program in 

A S C11 c h a r a c: t e r f o r m« F o r a d e t a i I e d d e s c r i p t i o n o f t h e 8 ~ r e c o r d f o r m a t, 
r e t e r t o A p p e n d i x E „ 


8 . 4 . 1 I n v o k i n q S E N D C 6 8 

1 n v a k e S E N D C 6 8 b y e n t e r i n g a c: o m m a n d 1 i n e i n t h e f o 11 o w i n g f o r m a t s 

8 E N D C 6 8 C - 3 1 n p u t f i 1 e t o u t p u 11 i 1 e 3 

T h e 8 E N D C 6 8 c o m m a n d 1 i n e c o m p o n e n t s a r e d e s c: r i b e d b e 1 o w « 


Component 


Mean!ng 


A h y p h e n i s o p t i o n a 1 « 1 f y o u s p e c i f y a h y p h e n , S E N D C 6 8 

d a e s n o t c r e a t e a n y 8 - r e c o r d s f o r t h e b s s s e g rn e? n t „ T h e 

r esu 11 i s a sma 11 er S-rec or d f i 1 e * I f you do not spec: i f y ax 

h y p h e n ? 8 E N D C 6 8 f i 11 s t hi e b s s s e g m e n t w i t h z e r o s« 

i n p u t f i 1 e F i 1 e t h a t S E N D C 6 8 c o n v e r t s t o t h e B—r e c o r d f o r m a t« T h e 

c o m m a n d f i 1 e m u s t b e a n a b s o 1 u t e f i 1 e i n t h & f o r m a t 

P r o c:i u c e d b y LI !*4 K 6 8L068, o r F< E L 0 C.. 


output f :L 1 e 


F i 1 e t h ax t 8 E N D C 6 8 s e n d s t h e n e w 8 - r e c a r d f i 1 e t o« 11 y o u 
d o n o t s p e c i i y a n o u t p u t f i 1 e, 8 E- N D C 6 8 s e n d s 11 "i e 8 - r e c o r d s 
t o t h e c o n s o 1 e s c: r e e n « 


8.4,, 2 SENDC68 Ex amp 1 e 

The following command line example illustrates how to convert an absolute 
c o m rn a n d f i 1 e i n t o a t i 3. e i n t h e M o t o r o 1 a 8 ••••* r e c o r d f o r m a t« I n t his e x a m pie, 
S E N D C 6 8 c: r e a t e s a n 8 • - r e c o r c:i f i 1 e n a rn e c:l P R 0 8 - S R f r o n i a n a b s o 1 u t e o o m rn a n d 
f i 1 e n a m e d P R 0 6» 6 8 K« 

i. a > > s e ri d c 6 — p r o g6 8 k p r o g « s r 

Note that the hyphen directs SENDC68 not to create S-records for the bss 
segment« 
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8„5 XREF UTILITY 

T h e X R E F u t i 1 i t y g e n e r a t e s a c r o s s - r e f e r e n c e? t a b I e o t s y m h o I s f o r G E M D 0 S 
o b j e c t f i 1 e s. X E E F o u t p u t 1 i s t s t h e s y m b o 1 s , t h e q b j e c t f i 1 e i n w h i c h t h e y 
a r b d e f i n e? d , a n d t h e o b j e c t t i I e s i n w h i c h t h e y a r © a c c e s s e d» X R E F 
p r a v i d e s a s e p a r a 1 0 1 i s t i n g f o r u n d e f i n 0 d s y m b o i s a n d t h e o b. j 0 c t f i 1 © s t h a t 
cal I them,, XREF accepts wi 1 dcards i n the object f i 1 e sped f i cat i one* 


8.5. 1 I n v o k i n g X E E F 

T o u s © X R E F „ e n t e r a c o m m a n d o t t h e f o 11 o w i rn q f □ r rn a t s 
X R E F o b j e c t -f i 1 0 .1. L o b j 0 c t f i. 1 e 2 « « , o b. j 0 c t til 0 1 a s 1 2 

Wh©r© H ob j ect f i 1 e 1 " i s the narne of the ob j ect t i 1 © t or whose symbo 1 s you 

w a n t a c r 0 s s ~ * r 0 f 0 r 0 n c e d t a b 1 e« M u 11 i p 1 0 o b. j 0 c t t i 1 e n a rn 0 s its a y h e 

sped t i ed« 


8« 5.2 X R E F E k a m p 1 0 s 

T h i s s ec t i o n c o rn t a i n s t w o e k a rn p 1 e X E E F c o m rn a n d 1 i n e s a n d h o w s t h © f o r rn ax t 

o f X E F o u t p u. t. 

1« T h e +’ o 11 o w i n g X R E F c o rn sin a n d g e rn e r a t © s ax c r o s s r e f © r e n c: e d t a b 1 e o t 

symbo 1 s f or the -file 6SXVAR„ 0. 

Ca> XREF G8XVAR.0 


Block Data? 


Symbol 

Defined In 

Accessed In 

cur ms b 

OSXVAR 


disabcm 

GSXVAR 


draw_f1 a 

8 S X V A F- 

« 

.angl 0 

GSXVAR 

MONOBJ MONOUi 

begamg 

USXVAR 

MONOBJ MONOUT 

Ursdet i ned 

E k t e r n a 1 R e f ea r 0 rn c 0 s s 

Symbol 

Def i ned I rn 

Accessed In 


ABLINE 

CHUR 


* * ■¥: k- * * # * M 0 N 0 U T 

¥r *s* *'fr jf -M- # Id (j |\| IJ U | 


MONOBJ 
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T h 0 0 x a m p I 0 X R E F c o m rn a n d s h o w n b 0 1 o w u s e s a w i 1 d c a r d t i 1 0 s p 0 c i. t i c: a t i o n 
t 0 g 0 n 0 r a 1 0 a c r 0 s & ~ r 0 f 0 r 0 n c 0 d t a h 1 © o t s y m b o I -e. *f 0 r 0 a c: h c::« b j 0 c t f i I 0 i n 
11 "i 0 c u r r 0 n i: «d i r 0 c 1 0 r y» 


(a)XREF *» 0 


Funcfcions 
Symbol 

arb_car 

arrow 

Cal cjt 


Defined In 

MONOBJ 
MOMOUT 
MONOUT 


Accessed In 
MONOUT 


E n d 0 f S 0 c t i 0 n 8 
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81D 6 8 D E B U G 8 E R 


SID 6 8 a 11 o w s y o u t o t e s t a n d d e b u g p r o g r a m s i n t e r a c t i v © I y 1 n t h e G E M D 0 E> 
e n v i r o n rn e n t. I h e p r e s 0 n t a t i o n o f i n t o r m a 1i 0 n i n t h i s s e c t :L 0 n a s s u m 0 s y o u. 
a r 0 f a rn i 1 i a r w i t h t h 0 M C68000 m i c r o p r o c e s s q r , t h 0 a s s 0 m b 1 0 r (A S 6 8) H a n d t h 0 
G E ii 1008 o p 0 r a t i n g s y s 1 0 m« 


9.1 INVOKING 8ID68 

I n v o k 0 S1.068 h y 0 n 1 0 r i n g o n e a t t h 0 f 0 11 0 w i n q c 0 m rn a n d s s 
BID 

SID fi1©name 

T h 0 f i r s t c: 0 m m a n d I 0 a d s a n d 0 x 0 c u t e 0 SID 6 8« A i 1 0 r i t i s I 0 a d 0 d * S1 D 6 8 
displays its sign-on message and the hyphen (-) prompt character to show it 
i s r 0 a d y 1 0 a c c 0 p t c 0 rn m a n d s« 

T h 0 s 0 c 0 n d c 0 m m a n d i n v 0 k 0 s £> ID 6 8 a n d 1 0 a d s t h 0 f i 1 0 s p 0 c i tied b y f i 1 0 n a m 0 « 
I f t h e f i 1 e t y p 0 i s n 0 1 s p e c i f i e d , i t d e f a u 11 s 1 0 t h e 6 8 K f i 1 e t y p e« T h e 
s 0 c 0 n d 1 0 r rn 0 f t h 0 c: 0 m rn a n d i s 0 q u. i v a I 0 n t 1 0 t h 0 f 0 1 1 0 w i n q s e q u. 0 n c 0 i n w h i c: h 
t h 0 f i r s t c 0 m m a n d i s i s s u e d a n d t h e n ^ a t t h e 91D 6 8 p r o m p t < s t h e & c: o rn m a n d i. s 
1 s s u 0 d 1 0 1 o a d a f i 1 0 1 0 r 0 x 0 c u. t i 0 n u. n d 0 r 81D 6 B n 

•[ a 5 81D 

SID68 

C c::« p y r i g h t 1982 » D i g i t a I R 0 s e a r c h 
.Et 1 1©name 


9 « 1. I 81D 6 £3 C 0 rn m a n d C 0 n v 0 n t i 0 n s 

W h 0 n 81D 6 £3 i s r e a ci y 1 0 a c c 0 p t a c: 0 m m a n d , i t p r 0 rn p t s y o u w i t h a hi y p h 0 r"i (• •••) « 
I n r e s p a n s ©, y 0 u a n t y p e a c o rn m a n d I i n e 0 r a C t r 1 - C < •"** C) t o e n ci t h e 

d © b u. g g i n g s 0 s s i 0 n» A c: 0 rn rn a n d 1 i n 0 c: a n h a v e a s rn a n y ax s 6 4 c h a r a c 1 0 r ? a n d 

m u. t h) 0 t e r m i n a t ee d w i t h a R 0 1 u r n « W h e n e n t e r i n g t h e e 0 m m a n d 9 u s 0 s t a n < j a r d 

G E M D 0 S 1 i n 0 0 c:i i 11 n g f u. n c: t i 0 n s t: a c 0 r r 0 c t t y p i n g 0 r r c::« r s „ 81D 6 8 d 0 0 s n 0 1 

p r 0 c 0 s s t in 0 c: 0 m m a n ci ]. i n 0 u n t i 1 y 0 u 0 n 1 0 r a R © t u. r n * 

T a b 1 0 9 i s u m m a r i z 0 s 81D 6 8 c 0 rn m a n ci s« 

i n t h i s s © c t i o n« 


T h 0 y a r 0 d © t i n e ci i n ci 1 v i d u a I 1 y I a 1 0 r 








^s~ 


6 e m D o s D o c u m e n t a t i o n 
Seria1 Number 006738 


T a b I e 9 — 1» 81 E>68 0o m m a n d S u m m a r y 


Command 


Action 


D Disp 31 .ay memory in hexadecimal and ABC1 1 « 

E L o a d p r o g r a m f o r e x e c u t i o n« 

F F i 1 1 m e m o r y b 1 o c k w i t h a c: o n s t a n t» 

G B e g i n e :•••: e c u t i o n w i t i‘ i o p t i o n a 1 b r e a k p o i n t s« 

HI U s e h e x a d e c i m a 1 a r i t h m e t i c » 

I 8 e t u p f i 1 e c: o n t r o I b 1 o c k a n d c o m m a n d t a i 1 « 

L L :i. st rnernor y us :i. n q MC68000 mnernon i c: s . 

H ii o v e m e m o r y h 1 o c k « 

F S e t a n d r e m o v e p:* e r rn a n e n t b r e a k p o .1. n t s» 

R R e a d d i s k t i 1 e i n t o rn e m o r y „ 

S S e t. m e m o r y t o n © w v a 1 u e s« 

T T r a c e p r o g r a m e x e c u t. i o n « 

U U n t r a c:; e p r o g r a m rn o n i t o r i n q* 

V S h o w m e rn o r y 1 a y o u t o t d i s k f i 1 e r e a d» 

W IaI r 11 e c o n t e n t s o f m e m o r y b 1 o c k t o d i s k » 

X E x a m i n e a n d m o d i f y C P U s t a t e» 


T h e c a m m a n d c: h a r a c t e r c a n b e i o 11 o w e d b y o n e o r rn o r e a r g u m e n t s „ w h i c h c a n 
be hexadecimal values, f i 1 ©names, or other information«, depending on the 
c o m m a n d » 8 o rn © c: o m m a n d s c: a n o p e r a t e o n b y t © , w o r c:l h o r 3L o n g w o r d d a t a« T hi 

1 e 11 e r s W t cd r w o r d o r L t o r 1 o n g w o r d m u s t b e a p p e? n d e d t o t h e c c:« m m a n d 
c: h a r a c: t e r f o r c o m m a n d s t h a t o p e r a t e o n rn u 11 i p 1 e d a t a 1 e n g t h s» A r g u m e n t s;- 
a r e is e p a r a t © cl f r o rn e a c: h o t h e r b y c o m m a s a r s p a c e s» 

e e 8 e c 13. o n 9« 2 t o r m o r © d © t a i 1 s o n © a c: h c o m rn a n cl» 


9 „ 1.2 A d d r e s s 8 p e c: i f i c a t i o n s 

li o s t 8130 6 3 e o m rn a n cl s r e q u ire o n © o r m o r © a d d r e s s e s a s o p e r a n d s« A1 i 

a d d r e s s e ci- a r e e n t e r e d a s h © x a d e c i m a 31 n u m b © r s o f u. p t o e i g h t h e x a d e c i m a 31. 

cl i g i t s (332 b i t s) „ 










6 e m D o s D o c la m e n t a t i o n 
8 e r :i. a 1 N u m b e r 006738 


9 * 1* 3 S y iti b o 1 R e t e r e n c e s 

£> ID 6 8 a 11 o w s y o la t c::« r e f e r e n c: e s y rn b o I s 1 n p 1 a c e o f a ci d r e s s e s » Y o u c a n 

d i s p I a y t h e s y m b o 1 s,, a 1 o n g w i t h t h e o t h e r d i s a s s e m b 1 e d i n s t r u c t i o n s i n y o u r 

e x e c: u t a b 1 e t i 1 e , b y u s i n q 1h b I.... c o rn rn a n d d e s c r i b e d i n S e c t i o n 9« 2„ 7« W h e n 

e n t b r :L n g a c o rn m a n d t h a t s p e c i f i e s a s y m b o 1 , p r e c e d 0 t h 0 s y m b a 1 n a m 0 w i t h a 
p e r 1 o d a s t o 1 I o w s u 


command«symbol 


F o r e x a m pie, t o d i r 0 c t t h & 6 0 c o rn rn a n d t o 0 x 0 c u 1 0 f r o rn t h e c u r r 0 n t F' r o g r a m 

C o u n 1 0 r (P C) t o t h 0 s y m b o 1 Q UIT i n t h 0 o b. j 0 c t f i 1 0 , 0 n 1 0 r s 


g , . qui t 

T h 0 C c: o m p i 1 0 r p la t s a n la n d 0 r s c o r 0 (_ > a t t h 0 b 0 g i n n i n g o f 0 x 1 0 r n a 1 s y rn b o 1 s« 
F o r 0 x a m p 1 0 9 t o s p e c i t y t h 0 G 0 e o m m a n d w i t h a b r 0 a k p o i n t a t t h 0 C f u n c: t i o n 
BLIVOT, enters 

g,«.hiivot 


9. 1* 4 S t o p p i n g SID 6 8 

81 o p 3 1D 6 8 b y t y p i n g a " C i n r e s p o n s 0 t o t h 0 hi y p h 0 rn p r o m p t « T h i s r 0 1 u r n 

c o n t r o i. t o t h 0 C C P « 


9« 1.5 31 D68 Op er at i on wi t h I n t er r up t s 

81 D 6 8 o p 0 r a t e s w i t h 1 n 1 0 r r la p t s 0 n a b 1 0 d o r d i s a b 1 0 d , a n c j p r 0 s 0 r v 0 s t h 0 
1 n 1 0 r r la p t s t a 1 0 o t t h 0 p* r o g r a m b 0 i n g 0 x 0 c la 1 0 cl u n d 0 r S 1 E) 6 8 « W h 0 n ID B hi a s 
c on t r o 1 ot t. hi e CPU H 0 i t h 0r wh en :L t i s i n i 1 3. a 11 y i n vok 0d or wh 0n i t r 0g a i n s 
c:: o n t r o 1 t r o m t h 0 p r - o g r a rn b e? i n g 1 0 s 1 0 d ,, t h 0 c o n d 11 i o n o f t h 0 i n 1 0 r r la p t rn a s k 
i s t h 0 s a m 0 a s i t w a s w h 0 n 81 D 6 8 w a s i n v o k 0 d , 0 x c 0 p t f o r a 1 0 w c: r i t i c a 1 
r 0 g i o n s w h 0 r 0 1 n 1 0 r r la p 1 0 a r 0 c:l i s a b 1 0 d « W h i 1 b t hi 0 p r o g r a rn bei n g t. 0 s 1 0 d h a s> 
c:: o n t r o 1 o f t hi 0 C P U , t h 0 u s 0 r " s C P U s t a 1 0 , w h :L c: h c a n b 0 d i s p 1 a y 0 ci w i t h t h 0 X 
c o m rn a n ci , t c j t e r m i n 0 s t h s t a 1 0 o f t h e? i n 1 0 r r u p t m a s k „ 

Note that SID 68 uses the Trace and II legal Instruction exceptions- 
Th 0r 0 f or 0, pr ogr ams ci0bugg0d la nci0r 1 0st shou I d not us0 t hiese „ 




G emDos D o c u rn e n t a. t i a n 
Serial Number 006738 




9.2 SID 68 COMMANDS 

7 h i s s e c t i o n d 0 f i n 0 s SID 6 8 c: o rn m a nd s a n d t hi © i r a r g u m 0 n t s* S ID 6 8 c o rn m a n d s 
a 11 o w y 0 u t o c o n t r o 1 p r o g r a m 0 x e c: u t :i. o n a n d d i s p 1 a y a n d m o d i f y s y s 1 0 m rn e m o r y 
a n d t hi 0 C F : * U s t a 1 0 « 


9 * 2« *1 T h 0 D (D 3 . s p 1 a y) C o rn m a n d 

T h 0 D c: o rn m a n d d i s p .1 a y © 1 h e c o n 1 0 n t s 0 1 m 0 m 0 r y a s 8 -• b i t,, 16 - h i t, 0 r 3 2 - h i t 

h 0 k a d 0 c i m a 1 v a 1 u e s a n d i n A S C 11 « T h 0 f a r m s a r 0 


D 

Ds 
Ds, f 
DW 
DWs 
DWs, f 
DL 
DLs 
DLs, f 

w h 0 r 0 s i s t h e s t a r t i n g a d d r 0 s s , a n d f i s t h e 1 a s t a d d r e © s t h a t SID 6 £3 
disp 1 ays« 

11 0 m 0 r y i s d i © p 1 a y 0 d 0 n o n 0 0 r rn 0 r e 1 i n 0 s« E a c h 1 i n 0 s h 0 w s t h 0 v a I u 0 s 0f u p 
to 16 memory locations. For the first three forms, the display line 
a p p 0 a r s a s 7 0 11 0 w s s 


aaaaaaaa bb bb » « « hb cc » . cc 


i,\i r i 0 r e a a a a a a a a i s t h 0 a cl d r 0 s s o i t h 0 d a t a b & i n g d i s p 1 a y 0 d ■ T h 0 b b s- 

r 0 p r 0 s 0 n t t h e c 0 n 1 0 n t s 0 f t h e m e m 0 r y 1 o c a t i 0 n s i n I"! e x a d €5 c i m a 1 , a n d t h e c c ' 
r 0 p r 0 s 0 n t; 11 "10 c: 0 n 1 0 n t © o f rn e m 0 r y 1 n A S C 11 « A n y n 0 n - g r a p h i c A 8 C 11 
c a r a c 1 0 r © a r 0 r~ 0 p r e s e n 1 0 d b y p e r i 0 d s „ 

I n r 0 s p o n s e 1 0 t h 0 D s f 0 r m o f t h e D c 0 m m a n d H s h 0 w n a b 0 v 0 , £ ID 6 8 d i © p 1 a y © 12 
1 i n 0 © t h a t s t a r t f r o m t h e c u r r e n t a d d r 0 © © „ 

F : ' 0 r m D s, f d i s p 1 a y s t h 0 m 0 m 0 r y b 1 0 c k b 0 1 w 0 e n 1 0 c a t i 0 n s s a n d t« F 0 r m s D W ^ 
DWs, and DWs,f are identical to D, Ds, and Ds 9 f except the contents of 
m 0 jti 0 r y a r 0 d i s p 1 a y e? d a s 16 ~~ b i t 0 r w C 3 r d v a 1 u 0 ?ii-, a s s h 0 w n b e 1 0 w s 


aaaaaaaa wwww wwww » « » wwww cccc «„„ cccc 


Forms DL, DLs, and DLs,f are identical to D, Ds, and Ds,f except the 
c o n 1 0 n t © o f m e m 0 r y a re d i s p 1 a y e d a s 3 2 - b i t 0 r 1 0 n g w 0 r d v a 1 u 0 s a © © h 0 w n 
belows 


aaaaaaaa 1 11111 1 1 1 1111111 n « » 11111111 cccccccc „« „ 

During a display, you. can abort the D command by typing any character at 
the console„ 









QemDos Documentation 
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9.2« 2 T h e E (L o a cl f o r E! x e c u t i o n) C o m m a n d 


The E command loads a file in memory so that a subsequent G, I, or U 
comm.and can begin program execution- The syntax for the E command is 

Eti1ename 

w h e r e f i I e n a m e 1 s t h e n a rn e o f t h e f i 1 e t o b e 1 a a d e cl „ I f n o f i J. e t y p e i s 

s p e c i t i e d , t h e f i 1 e t y p e 6 S K i s a s s u m e d » 

A n E c o rn m a n d r e u s e s m e rn o r y u s e d b y a n y p r e v i o u s E c o rn rn a n d „ T h u s , y o u c a n 

1 o a d o n 1 y o n e t i 1 e a t a t i m e t o r e x e c u t i o n „ 

W h e ri t In e i o a d i s c o rn p 1 e t e , 61D 6 8 c:i i s p 1 a y s t h e s t a r t i n g a n d e n d i n g a cl d r e s s. e s 
o f e a c I"! s e g m e n t i n t h e t i 1 e, l J s e t h e V c o m m a n d t o d i s p i a y t h i s i n f o r m a 1 1 o n 
a t a i a t e r 1 1 m e „ 

I f t h e f i 1 e cl o e s n o t e x i s t o r c: a n n o t b e s u. c: c e s s t u 11 y 1 o a d e ci i n t h e 
a v a i 1 a b 1 e m e m o r y, S X D 6 8 d i s p 1 a y s a n e r r o r m e s s a g e. S e e A p p e n d i x A t o r 
e r r o r m e s s a g e s r e t u r n e d h y SID 6 8 „ 


9« 2„ 3 The F (Fi11) Command 


T h e F c:: o rn m a n d f i 11 s a n a r e a o f rn e m o r y w 1 1 h a b y t e , w o r d , o r 1 o n q w a r d 

c o n s t a n t. T h e f a r m s a r e 

Fs << t h b 
FWs , f , w 
FLs , f , 1 

w h e r e s 1 s t h e s t a r t i n g a d d r e s s o f t hi e h 1 o c k i o b e f i 11 e d H a n cl f i s t h e 

a d d r e s s o f t h e f i n a 1 fa y t e o f t h e fa 1 o c k w i t h 1 n t h e s e g m e n t s p e c i f i e d i n s « 

I n r e s p o n s e t o t h e t i r s1 f o r rn , SID 6 8 s t o r e s t h e 8—b i t v a 1 u e b i n 1 o c: a t i o n 3 
s through f „ In the second -form, the 16-bit value w is stored in locations 
s t h r ou g h t 1 n s t a n d a r d f o r rn a t h e h i g h 8 fa i t s ar e f i r s t , f o 11 o we cl b y t h e 
I o w 8 b i t s« I n t h e t h i r d f o r rn , t h e 3 2 - h i t v a 1 u e 1 i s s t o r e d i n 1 o c a t i o n s s 
t h r o u q l"*5 f w i t h t h e li o s t S i g n i f i c a n t B y t e f i r s t u 

If s is greater than f„ SI068 responds with a question mark. Also, if b is 
q r e a t e r t hi a n F F h e x a d e c i rn a 1 < 255) , w g r e a t e r t h a n F : F F F h e x a d e c: i m a I 

(65 ,, 535) , or 1 q r e a t e r t h a n F F F F F F F F h e x a ci e c i. m a 1 (4,294,967,295) , SID 6 8 

r e s p o n cl s w i t h a c{ u e s t i o n rn a r k « S ID 6 8 d i s p 1 a y s a n e r r - o r rn e s a g e i f i t 
cannot read back the value stored in memory successfully. This error 

i n cl i c a t e s a f a u 11 y o r n o n - e x i s t e ri t R A M 1 o c a t i o n - 









G e m D o s D o c u m e n t a 1 1 o n 
S e r i a I N u rn b ex r 006738 


9 « 2 „ 4 T h e G (G o) C o m m a n d 

T h e G c: o rn m a n d t r a n s f e r s c o n t r o 1 t o t h e p r o g r a m b e i n g t e s t e d , a n d o p t i. o n a 1 i y 
s e t s o n e t o t e n h r e a k p o i n t s» T h e f o r m s a r e a s t o 11 o w s s 


(3 

6, b 1 , - - b .10 

03 

Os ,, b 1 , » » . b 10 

w h e r e s i s t h e a d d r e s s a t w h i c: h t h e p r o g r a m b e g i n s e x e c u t i n g a n d b i t h r o u g h 

b i 0 a r e a d d r e s s e s o f b r e a k p o i n t s» 

1 n t h e f i r s t t w o f o r m s, n o s t a r t i n g a cl d r ex s s i s s p e c i f i e d. 81D 6 8 s t a r t s 

e x e c: u t i n g t h ex p r o g r a rn a t t h e a d d r e s s s p e c i f i e d b y t h e Pro g r a rn C o u n t e r (P C) - 

1" h 0 f :l. r s t f o r rn t r a n s f0 r s «::: o n t r o 1 t o t h e p r o g r a rn w i t h o u t s e 11 i n g a n y 

b r e a k p o x n t s„ T h e s e c a n d f o r rn s e t s b r e a k p o i n t s b e f o r e p a s s i n g c o n t r o 1 t o 

t. h e p r o g r a m.. T h e 1 a s t t w o f o r m s a r e a n a 1 o g o u s t o t h e f i r s t t w o e x c: e p t t h a t 

t h e P C i s f x r s t s e t t o s,, 

0 n c:: e c: o n t r □ I h a s b ex e n t r a n s f e r r e d t o t h ex p r o g r a m u n d 0 r 1 0 s t, x t 0 x 0 c u 1 0 s i n 
r 0 a 1 -t x rn 0 u n t i 1 i t 0 n c o u n fc 0 r s a h r 0 a k p o i n t. A t t h :L s p o i n t., 91D 6 8 r a g a x n s 
c: 0 n t r 0 1 ,, c: i 0 a r s a 1 1 b r e a k p 0 x n t s , a n d d i s p i a y s t h ex C P U s t a 1 0 x n t h 0 s a m 0 
f 0 r m a s t h ex X c: o rn rn a n d« W h 0 n a b r ex a k p o i n t r e t u r n s c 0 n t r a 1 t o 81D 6 8 , t. h e 
instruction at the breakpoint address has not yet been executed- To set a 
b r e a k p o x n t a t t h e s a rn e a ci d r ex s s 9 y o u rn u s t s p 0 c i f y a T o r U c o m m a n d f x r s t * 


9« 25 T h 0 H < H e x a d ex c i rn a 1 M a t h ) C 0 m rn a n c j 

The H command computes thee sum and difference of two 32—bit values- The 
form i s 

Ha, b 

w h e r 0 a ax n d b a r e t h e v a J. u. ex s w h 0 s e s u rn a n d d i f t ex r ex n c e SID 6 Q c cj rn p u 1 0 s» 
81D 6 8 d x s p 1 a y s t h 0 s u m (s s s s s s s s) a n d t h ex ci i f f 0 r ex n c e (d d d d d d ci cl > t. r u n c a 1 0 d 
1 0 16 b i t s a s -f : 0 11 0 w s s 


s s s 3 s 3 s 3 ci d d d d d d d 


9, 2 N 6 T h e I < I n p u t C 0 rn rn ax n d T a i 1 ) C 0 m m ax n cl 

T In e 1 c o rn rn a n ci p r e p ax r e s ax f i 1 0 c o n t r o 1 b 1 o c k (F C B) a n d c o rn rn ax n ci t ax x 1 b u f f ex r' 
x n t h ex b a e -0 p ax g ex 0 f t h 0 1 a s t f i 1 ex 1 0 a d 0 d w :i t h t h ex E c o m rn a n cl - T h ex f o r rn i s 
as tol1 owes 

Icommandtax 1 

w h ex r ex c o m rn ax n d t a x 1 i s t h ex c: h a r a c t ex r s t r x n g w h x c:: h u u ax 11 y c o n t a x n s o n ex 0 r 
m o r e f i 1 e n a rn e s - T h e f i r s t f i 1 e n a m e i s p a s s e d i n t. o 11 "i ex d e f ax u 11 F x 1 ex C o n t r o 1 
B 1 o c: k ax t 005C H,, T h ex 0 p t i 0 n a 1 s ex c ex n cl f i 1 ex n ax m ex , i. f s p ex c 1 f i. ex d , x s p a s s 0 ci i n t cx 
t h 0 s 0 c: o r i ci d ex f a u 11 F i 1 ex C 0 n t r 0 1 B1 o c !••-: b ex g x n n i n g a t 0038H» T h 0 c h a r ax c t e r s 

i n t h ex c: o rn m a n ci t a 1 1 a r ex ax 1 s o c: o p i ex d t o t h ex d ex f a u. 11 c: o rr i rn ax n ci b u f f ex r a t 0080H» 
T h 0 1 ex n g t h o f t h ex c 0 rn rn a i ”i d t a i 1 i s s t o r 0 d a t 0080H 9 f a ]. 1 a w e d b y t h ex 

c h a r a c: t ex r s t r 1 n g t ex r rn i n a 1 0 cl w i t h ax b i n ax, r y z ex r o« 

I f a f x 1 0 h a s b ex 0 n 1 o a d 0 d w i. t h t h 0 E c o rn m a n d , SID 6 8 c o p x ex s t h 0 F i 1 e C o n t r ex 1 
B1 oc k an cl c: omman d b uf f er f r om t h ex h ase p ag ex of SID68 t o t h ex b asex p age of 
t h e p r o q r a m 1 o a d 0 ci - 










8 e m D o s D o c u rn e n t a t i o n 
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C ? 


7 h e L. (L i s t) C o m m a n d 


I" h e L c d m rn a n d 1 i s t s t hi e c o n t e n t s o f rn e m o r y i n a s s e m b I y I a n q u a g 0 - 7 h 0 f o r m s 

a r e a s f o 1 X 0 w s s 


L 

Ls 
Lb m f 


w h 0 r e s :i. s t h 0 s t a r t i n g a d ci r e s s n a n d f i s 1 h 0 1 a s1 a ci d r 0 s s i n t h 0 1 i s t „ 


T h e f :L r s t f o r rn 1 ists 12 X i n 0 s a t ci i s a s s e rn b X e d rn a c h i n e c a d 0 f r 0 rn t h e c u r r 0 n t 

address. The second form sets the list address to s and then lists 12 

X 1 n 0 s 0 f c 0 d 0 ,, T h 0 1 a s t f o r rn 1 i s t s d i s a s s e m b 1 0 d c: o d 0 f r 0 m s t h r o u g h f » I n 

a i I t h r 0 e c: a s 0 s , t h e X i s t a d d r 0 s s i s s e t t o t h e n e x t u n 1 i s 1 0 d X o c a t i o n i n 

preparation for a subsequent L command,. When SXD68 regains control from a 
p r o g r a m b 01 n g t e s 1 0 d < s 0 e G7' ? a n d U c: o rn rn a n d s) , t h 0 X i s t a d d r 0 s s i s s e t t o 
t h 0 a d d r e s s i n t h 0 P r o g r a m C o u n 1 0 r (P C) „ 


L o n g d i s p 1 a y s c a n b e a b o r 1 0 d b y p r e s s i n g a n y k 0 y d u r i n g t h e X i s t p r o c 0 s s . 
0 r s 0 n 1 0 r C t r X -- S < '• S) 1 0 h a X t t hi 0 d i s p 1 a y 1 0 rn p c:» r a r i X y« A C t r 1 - Q < • Q) 
r 0 s t a r t lis t h e d i s p X a y a f 1 0 r * S h a X t s i t „ 


7 h 0 s y n t a x o f t h 0 a s s 0 m b 1 y X a n g u a g e s t a 1 0 rn e n t s p r o d u c e d Id y t h 0 L c o m m a n ci i s 

d 0 s c r i b 0 d i n t. h 0 17 o t o r o X a i 6. 8 i t ii i c r o p r o c 0 s s o r U s 0 r ‘ s 17 a n u. a X , t h i r d 

0 d i t i o n , 17 C &8000U17 (A D 3) « S 0 c t i o n 9. 2» 17 d 0 s c: r i b e s s o rn 0 m i n o r d i. f f 0 r 0 n c 0 s 

b 0 1 w e e n t h 0 a s s 0 rn b X y X a n g u a g e s t a t e rn e n t s p r o d u c 0 ci b y t h 0 L c: o rn m a n d a n d 
hs t a n d a r d {7 o t c:« r o X a 68000 a s s 0 m b 1 y X a n g u a g 0 « 


9. 2« 8 7' h 0 17 < 17 o v 0 ) C o rn rn a n d 

T h 0 17 c c::* rn rn a n c J m o v 0 cc a b X o c i r o f d a t a v a X u 0 s f r c:« m c::« n ca a r e a o f rn 0 rn c:« r y t o 

a n o t ii 0 r « T h 0 f o r rn i a s f o 1 X o w s s 


Ms ,« f ,1 d 

w h 0 r 0 s i s t h 0 s t a r t i n g a d d r e* s s o i : t h & b 1 o c k t o b e m o v & d H f i s t h 0 a c:l d r 0 s s- 

o f t I n 0 f i n a i. b y t e cd f t h 0 b X o c k t o b 0 m o v 0 d , a n ci d 1 s t h 0 a d ci r 0 s s o f t h 0 
•f ; i r st b y 1 0 o f t h e ar ea t o r ec e i v 0 t h 0 d a t a. Mo t t l"i a t i f ci i s b et w ee?n s 

a n ci f c, p a r t o f t h 0 b 1 o c k b 0 i n g m o v 0 d w i 11 b 0 o v 0 r w r i 11 e n b 0 f o r e i t i s 
rn o v 0 d ,, t:> e c a li s 0 ci a t a i s- t r a n s f 0 r r 0 d s t a r t i n g f r o m X o c a t i c:? n s,, 




*24 ^ 
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9,, 2 * 9 T h e F' (P a s s P a i n t s) C o m m a n d 

T' h e P c: q m rn a n d s e t s „ c 1 e a r s , a n d d i s p 1 a y s p a s s p o i n t sT h e f o r m s a r © 

t ol1owss 

Pa h n 

Pa 

-P 


p a s ini- p o i n t i s a p e r m ax n e n t b r e a k p o i n t t h a t r e m a i n s i n e f f e c: t u n t i 1 y o u 
e x p 1 i c i 11 y r e m o v e i t, a s o p p o s e d t o b r e a k p o i n t s s e t w i t h 1h e G c o m m a n d t h a t 
rn u s t b e r e e n t e r e? d w i t h e a c: h G c o m m a n d. P a s s p o i n t s h a v e a s s o c i a t e d p a s s 

c o u n t s r a n g i n q f r o m i t o 0 F F F F H« T hi e p a s s c o u n t i n d x c a t e s h o w m a n y t i m e s 
t h e i n s t r u c: t i o n a t t h e p a s s p o i n t e x e c u t e s b e f o r e t h e c o n t r o I r © t u r n s t o 
the console,, SID6S can set up to 16 pass points at a time. 

An important distinction between breakpoints and pass points is that when 

e x e c u. t i o n s t o p s a t a b r e a k p o x n t, t h e x n s t r u c t x o n a t t hi e b r e a k p o x n t h a s n a t 

b e e n © x © c u t e d „ W h e n e x e c: u. t i o n s t o p s d u e t o a p a s s p o i. n t w h o s e p a e:- s c o u n t 
h a s r e a c h e d 1 , t h e i n s t r u c t i o n a t t h e p a s s p o x n 1: h a s h e e n e x & c u t e ci. T h i s 
m a k e r ; n- i t s i m p 1 e? t o p r o c © © d t r o rn a p a s s p a i n t w i t h a G c o m m a n d w i t h o u t 
e n c o u. n t e r i n g t h e s a m e p a s s p o i n t. 

i ::: o r m s P a , n a n d P a s © t p a s s p o i n t s« F o r m P a , n s © t s a p a s s p o i n t a t a d d r © s 

a (p a s is p o i n t a d d r e s 53) w i t h a p a s s c o u n t C3 f n (t r o rn i t o 0 F F F H) » I f a pas s 
p o x n t i s a 1 r e a d y a c t i v e a t a , t h e p a s s c o u n t i s c: h a n g e d t o n« SID 6 8 
responds with a question mark if there are already 16 active pass points. 

Form Pa sets a pass point at address a with a pass count of :l. „ If a pass 
p o i n t i s a 1 r e a ci y a c t i v e a t a d d r e s s a t h e p a s s c o u n t i s c h a n g e ci t o 1 i f i t 
i s n o t 1« 31D 6 8 r e s p o n d s w i t h a q u © cii. t i o n rn a r I*:; i f t h e r e a r e a 1 r e a d y 16 

a c t i v e p a s s p o i n t s . 

T h e . P f o r rn i s u s e d t o c i e a r p ai s s p o 3. n t s« 


9 „ 2. i 0 T h e R (R e a d) C o m rn a n d 

f h E:* i ::: - c o rri rn a n d r a d s a f i I © t c j a c o n t i g u o u is b I o c k i n rn e^ m o r y . T h e f o r rn a t i s 

Rfi1ename 

w h e r Ev -f i 1 e n a rn e x s t h e n a m e a n d t y p e? o f t hi © f i I e t o b e* r e a d „ 

81D 6 8 r e a d s> t h e f i i e i n t o rn e m o r y a n d d 3. s p 1 a y s t h e s t a r t x n g a n ci e i "i d i n g 

a ci d r e s s e s o f t in e b I o c k o f rn © m o r y o c c:: u p i © d b y t h e f i 1 © „ A V a I u e < V) c: o rn m a n ci 

c a n r e d i s}::) 1 a y t h e i n f o r m a t i o n a t a 1 a t e r t i rn e« T h e d e f a u 11 d x s p 1 a y 

P o i n 1 0 r ,, f o r u b s e q u e n t D i s p i a y (D) c:: c:« m m a n ci s i s s e t t o t h © e> t a r t o f t h © 

b 1 o c k o c c u p i e d b y t h e f i 1 e • 
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1 :i. 


T h e 8 (S e t > C o m rn a n d 


f h e S c o it i m a n d c: a n c h a n g e t h e c o n t e n t s o f b y t e s , w o r d s „ o r I o n g w o r d s i n 
m e m o r yT h e f o r m s a r e 


Ss 

SWs 

8Ls 


w h e r e s 1 s t h e a d d r e s s a t w h i c: h t h e c h a n q e i s t o o c c: u r * 

81D 6 8 d i s p 1 a y s t h e rn e m o r y a d d r e s s a n d 3. t s c u r r e n t c o n t e n t s » 1 n r e s p o n s e t o 

t h e -f i r s t f o r m , t h e d i s p 1 a y i © 


aaaaaaaa bb 


J.' n r e s p o n s e t o t h e s e c: o n d t o r rn, t h e d i s p 1 a y i s 
a a a a a a a a w w w w 

I n r e s p o n s e t o t h e t h i r d f o r m, t h e d i s p 1 a y i s 
aaaaaaaa i J. 1 11 x i 1 

w h e r e b b w w w w ,, a n d 11111111 a r e t h e c: o n t e n t s c:«f rn e m o r y i n b y t e w o r d , a r"! d 

1ongword formats, respectively» 

I n r e s p o n s e t o o n e o t t h e a b c:) v e cl i s p 1 a y s, y o u c a n a 11 e r t h e rn e rn o r y J. o e a t i o n 
q r 1 e a v e i. t u n c h a n g e d. 11 y o u e n t e r a v a 1 1 d h e x a d e c 3. rn a 1 v a 1 u e „ t h e 

c:: o n t e n t s o i t h e b y t e , w o r d , o r 1 o n g w o r c J i n m e n t o r y i s r e p 1 a c e ci w i t h t h a t 
v a X u e« 11 y o u d o n o t e n t e r a v a 1 u e , t h e e o n t e n t s a f rn e m o r y a r e u n a f t e c t e d 

a ri d t h e c. o n t e n t s c:) i- t h e n e x t add r e s s a r e c j i s p 1 a y e d« I n i t h e r c a s e, S ID 6 3 

continues to display successive memory addresses and values until either a 
p e r i o d o r a n i n v a 1 i d v a 1 u e i s e n t e r e cl. 

SID 6 8 d i s p 1 a y s a n e r r o r m e s s a g e i f i t c: a n n o t r e a d b a c k t h e v a 1 u e s t o r e d i n 
rn e rn o r y c> u c: c e s s t u 11 y „ T h i s e r r o r i n d i c: a t e s a t a u 11 y o r ri o n e x i s t e n t R A M 

1ocation « 
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9« 2 „ 12 T h e T < 1 r a c e) C o m rn a n d 

The T command traces program execution for i to OFFFFFFFFH program step 
The forms are 


r 

In 
1 w 


w h e r e n i s t h e n u m b e r o f i n s t r u c t i o n s t o e x e c u t e b e t o r e r e t u r n i n g c o n t r o 1 

t o t h e c o n s o 1 e» 

A11 e r S1.068 t r a c e s e a c h i n s t r u c t1 o n , i t d :i. s p 1 a y s t h e c: u r r e n t C P LJ s t a t e a n d 
t h e d i s a s s e m b 1 e d i n s t r u c 1i o n i n t h e s a m e f o r m a s t h e X c o m m a n d d i s p 1 a y. 

C o n t r o 1 t r a n s f e r s t o t h e p r o q r a rn u n d e r t e s t a t t h e a d d r e s s i n d i c: a t e d i n t h e 
p r o g r a m c o u n t e r « I f y o u d o n o t s p e c i f y n , o n e i n s t r u c t i o n is e x e c u t e d. 
Otherwise, SID68 executes n instructions and displays the CPU state before 
e a c h s1 e p Y o la c a n a b o r t a 1 o n g t r a c e h e f o r e a 11 t h e s t e p s h a v e b e e n 

e x e c u t e d b y p r e s s i n g a n y c h a r a c t e r a t t h e c o n s o I e«, 

Th e T w f o r m t r a c e s e x e c u t i o n w i t h o u. t c a 11 s t o s u b r o u t i n e s» T h e e n t i r e 
u b r o u t i n e c a 11 e d f r o m t h e p r o g r a m 1 e v e 1 b e i n q t r a c e a i s t r e a t e d a s a 
single program step and executed in real time. This allows tracing at a 
h i g h 1 e v e 1 o f t h e p r o g r a m, i g n o r i n g s u b r o u t i n e s t h a t a r e a 1 r e a d y d e b u g g e d - 

A f t e r a T c o m rn a n d , t h e 1 i s t a d d r e s s u s e d i n t h e L c o m m a n d i s s e t t o t h e 
a d d r e s s o f t h e n e x t i n s t r u c t i o n t o fo e e x e c u t e d » 

N o t e t h a t 81D 6 8 d o e s n o t t r a c e t h r o u q h a B D 0 8 i n t e r r u p t i n s t r u c t i o n s i. n c: e 

SID68 itself makes BE)08 calls and the* BOOS is not reentrant. Instead, the 
e n t i r e* s 0 q u e n c e o f i n s t r u c: t i o n s f r o m t h e B008 i n 1 0 r r u p t t h r o la q h t ti e r e t u r n 
f r o m 8 D 0 8 i s t r e a t e d a s o n e t r a c e d i n s t r u c t i o n » 


9» 2« 13 T ti e U (U n t r a c e > C o m m a n d 

T h e U c o rn rn a n d i s i c:i e n t i c: a I t o t h e T r a c e (T) c o rn m a n d e x c e* p t t h a t t h 0 C P U 

state is displayed only after the last instruction is executed, rather than 

a i t e r e v e r y t e p « T h e f o r m s a r e 

U 

Un 


w h e r e n i s t h e n u m b e r o f i n s t r u c: t i a n s t o e x e c: u t e e f o r e c o n t r o 1 r e t u r n s t o 
t h 0 c o n s o 1 e« Y o u c a n a b o r t t h e c C3 m m a n ci h e f o r e a 11 t h 0 s t e p s ii a v e b e e n 
e x e c u t e d b y p r e s s 1 n g a n y k e y a t t h e c o n s o 1 e» 
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9 „ 2„ 14 T h e V < V a 1 u e) C o m rn a n d 

T h e V c o rn m a n d d i s p 1 a y s i n f o r rn a t i o n a b o u t t h e 1 a s t f i 1 e 1 o a d e d w i t hi t h e L o a d 

F o r E k e c u. t i o n (E) o r R e a d C R) c o m m a n d s ■ T h e f a r rn i s 


I f t h b i a s t f i 1 e w a s I o a d e d w i 1 h t h e E c o rn m a n d , t h e V c: o m rn a n d d i s p 1 a y s t h e 
s t a r t i n g a d d r 0 s s a n d 1 0 n g t h o f e a c h o f t h 0 s 0 g rn 0 n t s c o n t a i n 0 d i r s t h 0 f i. 1 0 ,, 

t h 0 b a s 0 p a g e? p o i n 1 0 r ,, a n d t h 0 i n i t i a I s t a c: k p o i n 1 0 r „ T h 0 f □ r rn a t □ f t h 0 

di sp 1 ay :i s 

f 0 '•< t b a s 0 00000500 c:l a t a b a s e ::::: 00000B 7 2 b s s b a s 0 0 000 3F D A 
t 0 x t 1 0 n g t h ::::: 00000672 d a t. a 1 e n g t h :::5: 00003468 h s s I 0 n g t h=00 00 A1B 0 
b a s e p a g 0 a d d r e 0 s = ::: 00000400 i n i t i a 1 s t a c k p 0 1 n 1 0 r000066D 4 

1f n o f 1 1 0 h a s b 0 0 n 1 c:j a d ed „ SID 6 8 r 0 s p 0 n d s t a t h 0 V c o m m a n d w i t hi a q u 0 «•> t i o i"i 

rnar k 


9» 2« 1 -5 T h 0 W < W r i 1 0 ) C o m m a n d 

T h 0 W c: o fTi m a n d w r i 1 0 s t h 0 cr. o n 1 0 n t s o f a c: o n t i g u o u s b 1 o c k o f m 0 rn 0 r y 1 0 d :i. s » 

The forms are 


k!f i 1 ©name 
Wfi 1 ©name,s,f 

T h0 t i 1 E^n am© i s t h0 f i 1 e^ spec: i f i cat i on of t h0 d i s k f :i. 1 0 that r e?c 0i ves 11 "!0 
data „ 

I f y 0 t.i u & © t h 0 f i r s t f 0 r rn , t SID 6 8 a s s u rn 0 s t h 0 v a I u 0 s *f 0 r s a n d f f r 0 m t h 0 
1 a s t i i 1 0 r e a d w i t h a n R c 0 m m a n d . I f n o f i 1 e h a s b 0 e n r e a d i:) y a n R 
c 0 rn rn a n d „ SID 6 8 r 0 s p o n d s w i t h a q u 0 s t i 0 n m a r k « T h i s 1 0 r rn i s u © f u 1 f 0 r 
w r :t t :t n q o u t f i 1 0 s a f t e r p a t c h 0 s h a v 0 b 0 e n i i"i s t a X 1 0 d . s a s s u m i n g t h 0 a v e r a X 1 
X 01 "1 g t h 0 f t h © f i 1 0 i s u ri c h a n g 0 d 

1 n t h 0 s ev c 0 n d f o r rn t h 0 1 0 1 ter s s a n d t a r © t h e f i r s t a n ci 1 a s t a d c:l r e? s s Ev- s 0 1 

th© block to be written. If f does not specify the last address, SI 068 

u. 0 0 s t h & s a rn 0 v a I u eo? t l" *i a t w a s u s 0 d f o r s. 

I f t h 0 f i 1 0 sp : 0 c i f i 0d i n t h 0 W c ornm an d a 1 r 0 a d y ©x :i t s o n d i s k „ 81 D 6 

d 0 1 0 1 © 0 t h 0 0 x i s t i n g i ; i 1 e? b 0 f c::« r e 11 w r i t e? s t h 0 n 0 w f i I 0 „ 
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9, 2 « i 6 T h e X (E x a m i n e C P U S t a t e) C o rn rn a n d 

T h e X r.r. o m m an d d i s p 1 a y s t h e e n t :i. r e s t a t e o f t h e C P U, i n c 1 u d i n g t h e P r o g r a m 

Counter (PC), User Stack Pointer (USP), System Stack Pointer <SSP), Status 
Re q 1 s t e r (8 T d :i. sp 1 a y e d b y t i 0 1 d) , a 11 0 i g h t d a t a r 0 g i s 1 0 r s , a i i e i g h t 

a d ci r 0 s s r e g i s t e r s , a n ci t hi 0 d 1 s a s s 0 m h 1 0 ci i n s t r u c t i o n a t t h e m 0 m a r y a d d r 0 s s 

c li r r e n 11 y 1 n t h 0 P C: „ T h 0 f o r m s a r e 


Xr 

w h 0 r 0 r i s o n 0 o t t h 0 f o I 3. o w i n q r 0 g i s t e* r s 2 

DO to D7 h AO to A 7 , PC , USP, or SSP 

Th 0 T i r st T or rri d i sp I ays t h 0 CPU st a1 0 as T o 11 ows s 

P C00016000 U S P -00001000 8S P=00002000 S 7 « F F F F - > (e t c - ) 
D 00001000 00000D01 00000001 

A 000B0A00 000A0010 » » » 00000000 
i ea # 16028 n AO 


T h 0 f i r s t 1 i n e i n c 1 u d e s s 


P C p r o q r a m c o li n 1 0 r 

U S P u s 0 r s t a c k {:::> o i n t 0 r 

S S P s y s t e m s1 a c k p o i n 1 0 r 

97 status register 


F o 11 0 wi n g t h 0 st at us r eg i s1 0 r c: on 1 0 n t s on t h e f i r st d i sp 1 ay 11 n 0 , y ou s 00 
t h 0 v a 1 u. 0 s a f 0 a c: h b i. t i n t h 0 s t a t u s r 0 g i s 1 0 r 9 a s s h o w n i n t h 0 f cj 11 o w i n g 
s a rn pi es 

TR SUP IM«7 EXT NEB ZER OFL CRY 


7 h i s s a m p I 0 ci i s p 1 a y i n c 1 u d 0 s 2 


TR 

SUP 

I M=7 

EXT 

NEB 

ZER 

OFL 

CRY 


Trace Bit 

S u p 0 r v i s o r M o d 0 B i t 
I n 1 0 r r li p t M a s k ::n: 7 
Ex ten ci 
Meg at :i. ve 
Z er o 

Overti cm 
Carry 


T h 0 s e c 0 n ci t o r n'f, X r , a 11 o w s y o u 1 0 c h a n g e t h e v a i u 0 i n t h 0 r 0 g :i. s 1 0 r s 0 f t i i 0 
program being tested. The r identifies the register, 9IDS8 responds by 
d i s p 1 a y i n g t h 0 c u r r 0 n t c c:> n t e n t s o f t h 0 r e? g 1 s t e r „ 1 0 a v i n g t h 0 c u r <•;> c:> r o n t h a t 
l x n e» I f y o u t y p 0 a R e t u r n , t h e v a 1 u 0 i s n o t c h a n g e d . I f y o u t y p e a n 0 w 

v a 1 i d v a 1 u 0 a n cJ t h 0 n a R 0 1 u r n , t h 0 r 0 q i s t e r i s c: h a n g 0 d t o 11 - 10 n 0 w v a 1 u 0 „ 
Y o u c a n c h a n g e t i-“i 0 c o n t e n t s o f a 11 r e g i s t e r s 0 x c 0 p t t h 0 s t a t u s r e? g i s 1 0 r 
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9» 2 „ 17 A s s e m b I y L a n g u a g e S y n t a k f a r t h e L C o m m a n d 

I n g e n e r' a 1 , t h e s y n t a o f t h e a b s e rn h1 y 1 a n g u a g © s t a t e m e n t s u. s © d i n t h e L 

c o m rn a n d i s s t a n < j a r d 11 o t o r o 1 a 68000 a s s e m b 1 y 1 a n g u a g e« 8 e v a r a 1 m x n o r 

e;< cep t i ons ar e g i. v©n i n t he f o 11 owi ng 1 :i si s 

* SI D 6 8 p r i n t a 11 n u rn e r :l. c v a 1 u e i n h e a d e c i rn a I « 

* SI D 6 8 u s © s 1 o w e r c: a b e rn n © rn o n i. c nn-« 

* 81D 6 8 a s b u m e s w o r d o p e r a 11 □ n s u n I e s s a h y 1 e o r j. o n g w o r d s p e c x i x c::: a t x o n 

i s © k p 1 x c i 1 1 y s t a t © d « 


E n d o f S © c t i c> n 9 
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SUMMARY OF BIOS FUNCTIONS 


fable A.i lists the BIOS -functions supported by GEM DOS. 


T a h 1 e A ••••• 1» S u rn m a r y o f B10 S F u n c t i o n s 

0 0 G e t M e m «::?• r y P a r a rn e t e r B i a c k 

V 01D 8 e t.M P B C p .... M P B) 

MPB ; 

‘L 

Fill in Memory Parameter Block at p J v iPB„ 


C h a r a c t e r i n p u t s t a t u s 

LONG Char_In_Stat(handle) 

WORD handle; 

i t ( d e v i c e i s r e a d y) 

return (-1)n 

return <0); 


0 2 C h a r a c t e r i n p u t 

L 0 N G C h a r..... I n p u t (h a n d 1 e) 

WORD handle? 

.r 

r e t u r n (c:: h a r a c t e r f o r d e v i c e h a n d 1 e " ) s 

0 3 C h a r a c t e r o u t p u t 

V 01D C h a r ... c::« u t p u. t (h a n d I e h c h a r ) 

W 0 R D h a n d i. e ? c h a r ; 

0 u t p u t c h a r t o d e v i c e h ax n d 1 e . C h a r a c t e r rn a y b e 

output di red: 1 y *f or po'i I ed output, or enqued f or 
i n t e r r u. p t d r i v & n o u t p u t« 
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T ab i 0 A— 1 m < c: on t i nued ) 


R e a d / W r i t e d i s k s e c t o r s 


LONG 

H E! a d.W r i 10.s & c: 10 r 

s (w r t fig, b u f f 0 r h c 0 u n t,, b 0 g i n , d r i v 0 

WORD 

wrtf1g 5 

/ * 0 2 r 0 a d , Is w r i 10 * / 

BYTE 

^buffer 5 

/ * a d d r e s s 0 f t r a n s i : r b li f f 0 r * / 

WORD 

count 5 

/* number of sectors to transfer •*/ 

WORD 

begin 5 

/ * b 0 g :i. n n i n g s 0 c: 10 r n u m b 0 r * / 

WORD 

drive; 

/* 0: A, 1: B, ... */ 


P 0 r f 0 r rn i ri d i c a 1 0 d 

d i s k 0 p 0 r a t i 0 n 


return (error indication or E JGK) n 

Get/Set 

0 x c 0 p t i 0 n v 0 c 10 r 


LONG 

G 01 8 e t V 0 c 10 r (n , 

ad dr) 

WORD 

n; 

/ * v 0 c: 10 r n u m b 0 r f 0 r 0 p 0 r a t i 0 n * / 

LONG 

a ij d i ,j 

/ * a d d r 0 ss / p a r a e1 0 r v a 1 ue * / 

t 

1 0 rn p ~~ v 0 c 1 0 r 1" n 3 ;; 



i f <addr ! — 1 L) 



v e c t o r C n 3 = a d d r s 
return (temp)5 




E x t e n d e d v e c: t o r s 

0 x 101 C r 1 1 i c a 1 e r r o r h a n d 1 e r 

11 i s t h0 r esponsi b i 1 i t y of t he E< 108 t o i n vok0 t he 
r o u t i n e a t t h i s v e c t o r w h e n e v e r a d i. s k r e 1 a t e d c: r i t i e a I 
e r r o r o c:: c u r s, s u. c h a s w r 110 f a u 11, d r i v 0 n o t r 0 a d , 01 c« 

1t i s t h 0 r 0 s p o n s :i b i 1 :i t y o f t h 0 h a n d 1 e r t h a t i n s t a 11 s 
i t self t o s a v e d 3 - d 7 / a 3 - a 7 i f t h e? y a r 0 u s 0 d« T h e e r r o r 
i"i u m b 0 r o f t h 0 c r i t i c: a 1 0 r r o r i s a W 0 R D p a r a m 0 1 0 r o n t h e 
stack„ 


T o i q n o r 0 t h e 0 r r o r , s 01 D 0» L t. o 0 a n d r 01 u r n „ 

To retry, set D 0 «L to 0 x 10000 and return,, 

T o a b o r t,, m o v 0 e r r o r p a r a m 010 r t o I) 0 a n d s i q r i 
0 x 10 n d i. t t o a L 0 N G« 
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T a b I e A -■ 1 < c o n t i n la e d ) 


11 t hi 0 t a r g e t s y s t e m i s i n t e n d 0 d t a s u p p a r t c h a r a c t e r - 

b a s e d < t h a t i s, n o n.6 E M r e 1 a t e d) a p p 1 i c a t i o n s h i t i s t hi e 

r 0 s p o n s i b i I i t y o f t h e B10 S i m p 1 e m e n t o r t o m a k e th e c o n s o I o 

I / 0 p o r t i o n o f t h e B10 8 r - e n t r a r? t t r o rn t h i s h a n cl 1 e? r 

s o t h a t u s e r p r o rn p t i n g c a n b e d o n 0 „ 

t J h 10 2 T 0 r m i n a 1 0 h a n d 1 e i"' 

II i s 11“ *! 0 r 0 s p o n s i fo i 1 i t y o f t h 0 hi a n d 1 0 r t o a 0 1 0 r rn i n 0 w h t h 

i t ih> h a u 1 d a 11 o w t h 0 p r o c 0 ns s 1 0 r m 1 n a t i o n t o c o n t i. n u e» 

T o 1 0 r m i n ca 1 0 , t 1 rn p 1 y R T S« 01 h e? r w :i. s 0 , t 1 o n g j u rn p ; b a c k 

i n t a t h 0 m a i. n c o d 0 o f t h 0 j::) r o c: 0 s s« 


G0t tick info 
LONG get_tic ks() 

r 

r 0 1 la r n (n u rn b 0 r o t m i 11 i s e c: o n d 0 p e r tic k > ;i 


Got BI OS Par arnet er B1 oc k 

B P 8 * g 0 1 _ b p b (d r i v 0 ) 

WORD drive; 

1 f m la 11 i 1 0 m e d i a t y p s a r s la p p o r 1 0 d o n d r i v 0 ,, 

d 0 1 0 r rn i n en t y p 0 o f m 0 d i a „ 

r 0 1 la r n (p o i n 1 0 r t o B P B f o r t h i s d i s k ) ; 


C h a r a c 1 0 r c j la h p la t s t a t u s 

L_ 0 N 8 C h a r.G la t 81 a t (hi a n d i 0 ) 

WORD handI 0 ; 

/ 

i. 

I i (d 0 v :i. c: 0 1 s r 0 a d y *f o r o la t p la t) 
roturn (-1)5 


roturn (0)^ 
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T a b I e A .1« <c o n t i n li e* d) 

ti e d i a c h a n g e 

M e d i a _ C h a n g e (d r i v e) 
drive; 

i f (m e d i a h a s n o t c h a n g e d) 
return (0) ; 

:l. t < rn e d i a rn a y h a v e c h a n g e d) 
return ( 1 ); 

i f C rn e d i a h a s d e t i n i t e 1 y c h a n g e d) 
return (2); 


0 A 0 e t d r i v e m a p 

L 0 N G 8 e t _ D r i v e _ M a p () 

\ 

r e t u r n (h i t rn a p o f a c c e s s i b I e d r i v e s o n s y s t e rn > 

•» 

j 

W h e r e b i t 0 r e p r e s e n t s d r i v e A n e t c: „ 

N 0 T E n I f t hi e B10 8 li p p o r t s 1 o g i c a 1 d r :i. v e s A a n d B o n a s i n g i. e p h y s i c: a J. 

i t s o u 1 c:i r e t u r n b o 11 ”! b i t s s e t i t a $ 1 o p p y d i. s k i s p r e s e r\ t« 

0 B G e t / 3 e t s h i $ t k e y (c a n s o 1 e) 

L 0 N 6 0 e t _ 8 e t _ S h i f t (i 1 a g) 

WORD t1ag; 

temp = state; 
if (flag != -1) 

state ::::: flags 
r e t li r n ( t e m p ) ; 

J* 

f h 0 b i t i n f 1 a g a r e a s s i g n e c:! t o b e s 

0" R i g h t s h i f t k e y 

1 s L e f t s h i f t k e y 

2s Control key 

3n Alt key 

4 s C a p s 1 o c k k e y 


LUNG 

WORD 
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Tab1e A—i« <continued) 

C h a r a c t e r c o n t r o 1 i n p u t 

L 0 N G C h a r .... C t i _ I n (h a n d I e „ i e n g t h , b u 11 e r ) 

WORD hand 1 e, 1 eng t h5 

B V T E * b u 11 e r u 

\ 

R e a d u p t o “ 1 e n g t h b y t e b f r o m ' h a n d 1 e s c: d n t r o I 
c h a n n e I i n t o b u f f e r. 

C a 11 e cl w i t h ‘ 1 e n g t h ' = 0 t o d e t e r m i n e i f 

d e v i c e a c: c e p t s c o n t r a 1 s t r i n g s« 


C h a r a c t e r c: o n t r o 1 o u t p u t 

L 0 N G C h a r .... C11 _ 0 u t (h a n d 1 e , 1 e n g fc h , Id u f t e r) 

W 0 B D h a n d 1 e, 1 e n g t h 5 

B Y T E * h u f f e r 

*1 

(aJ r i t e i e n g t h b y t e s t o h a n d 1 e ’ s c on t r o 1 c h an n e 1 t r o m b u f t e r « 


D i s k c 0 n t r o 1 i n p u t 

L 0 N G D i s k.C11 _ I n < d r i v e, 1 e n g t ri, b u 11 e r ) 

W 0 R D d r i v e , 1 e n g t h 5 

BYTE! '^buffer 5 
•C 

R e a d u p 1 0 J i e n g t h b y t e s f r q m h a n d I e " s c 0 n t r 0 1 c h a n n e 1 

i n t o b u f f e r . C a 11 e d w i t h J 1 e n g t h ' = 0 10 d e t r m i n e i. t 

'■ h a n d I e a e c e p t s c 0 n t r 01 s t r i n g s» 


D i s k c o n t r 0 1 0 u. t p u. t 

L 0 N 8 D i s !•:; C11 ... 0 u t (cl r i v e , I e n g t h , b u f f e r ) 

W 0 R D d r i v e v 1 e n g t h 5 

B Y T E * b u f f e r ;; 

/ 

W r i t e ' 1 e n g t h " b y t e s t o ' h andle's c: o n t r o 1 
c: h a n n e 1 f r o rn " buffe r " » 
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T a b 1 e A • •• .1.„ *; c o n t i n u e cl > 


C h a ! '■ a c t e r v e c t d r e x c h a n g e 

L... 0 N 6 C h a r V e c E x c: h a n g e (h a n d 1 e , a d d r e s s) 

WORD handle; 

L 0 N 6 a d d r e s s; 

%. 

t e m p = ‘ h a n die s o I cl h a n cl I e r a d d r e s s 5 

I n s t all "ad cl r 0 s s a s ' v e c t o r ‘ s 

n 0 w I o g i c a 1 i n 10 r r u p:) t h a n d 1 e r « 

return (temp); 


11 i s n o t b t r 1 c 11 y n 0 c 0 s s a r y t o i m p I 0 rn 0 n t 
th i s f unc t :t on f or CON ,1 i n th 0 c:ur r en t r 0 1 ease of 
BEN DOB» 
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S t a c k f o r m a t 

•f or 

i n v o c a t :i. o n o f c h a r a c t e r v e c: t o r 

SP"i“8 

LONG 

(see belaw) 

Sp”i“4 

LONG 

f 1 aqs 

sp 

LONG 

r e t u r n a d d r e s s 

Interpr 

etati 

o n o f b i t s i n f 1 a g s L 0 N G s 


handIer 


P a c k 0 t r e c e i v e d 

1 1 t h i s i s 1 , t h e n t h e i... 0 N 8 a t s p •+• 8 :i. s d e f i n e d a s 

F o r C 0 N s , A U X : , o r P R N 2 

T h e L 0 N G c h a r a c t e r i n f o t h a t B10 S 
f u n c t i o n 0 x 0 2 w o u 1 d h a v e r e t u r n e d „ 

For CLOCK 


F or 


T h 0 n u m h e r o f m i 11 i s e c: o n d s s i n c: e t h e 
1 ast t i c:k . 

MOUSE 


A pointer to a 
A BYTE! of 
A BYTE of 
A BYTE of 


p a r a m e t e r b 1 a c k 
b u 1t o n s t a t u. s 
del ta~~X 
delta-Y 


that 


contai n 


1 Error 


I f n o d t h e r e r r o r s t a t u s b i t i s o n , 
t hi :i. s i s j u s t a r? e r r c:« r t hi a t c o u 1 ci r i t b e 
described any better with the available 
d e f i n e d s t a t u s b i t s. 


Out of paper 
Off line 


4 Timeout 

5 F r a rn i n g E r r o r 

6 Parity error 

7-15 RESERVED 


If no packet received and no error then state changed 
o n o n e o f t. h e f o i. J. o w n. n g: 


1 6 

C a r r :i. e $ r d e t e c t 

17 

Clear to send 

18-31 

RESERVED 


(!!j n I y r eo g i s t e r A 7 m u s t b e p r b e r v e d b y a v e c t o r h a n d 1 e r „ 

The handler must jump to the next handler in the chain (at 

r e t u. r n e? d b y t h e F 10 C t !L c: h a r a c:: t e r v e c t o r e x c h a r"i g e? f u n c t i o n ) ,, 

•f o r t h e c 1 o c k t i c k „ 


the address 
particularIy 
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t e m I n i t i. a 1 i z a t i o n S e q u e n c e s 
D i s a b I e i n t e r r li p t s i f n e c e s s a r y» 

Per-f orrn necessary ch i p and per i pheral i ni ti al i zat i on to put the HW 
e n v 1 r o n rn e n t i n a q u i e s c: e n t s t a t e« 

Initialize TRAP # 13 vector to the B108 s handIer adc;dress« 

I n i t i a I i z e s e c: t o r b u f f e r s s i m i I a r t o t h e f o 11 o w i n g c o d e s 


char 
BCB 
BCB 
b c b x 
bcbx 
b c:: b x 
b cbx 
bcbx 
bcbx 
b e b x 
ta c b x 
b c b X 
bcbx 
b uf I 
buf 1 


secbufC 43C5123 
bcbx L43 ; 

*buf 1 122 u 

b.1 i n k = 

bi _ 1 i n k : - :: 

b.bufdrv 

b.but drv 

b.butdrv 

b^butdrv 
b but r = 
bbutr = 
b_butr - 
b_bu.tr = 

- >S:bcb; 

— bcbx II2II 


c o ::i, 

1:2:1 

C03, 
I! 1 3 

[ 3 3 
l 0 2 , 

r: 13 
1:2:1, 
C3 3 
C 0 3 

c 1 3 


&b c b x l i 3 ; 

;^bcbx C33 5 
« -15 
* -15 
v = -I 5 

V = -1 ; 

= s e c b u f i: 0 3 I’.' 0 3 ; 
= &secbuf C 1 3 i: 0 3 $ 
— & s e c b u t l: 2 3 1: o :i n 
?/. s e c b u 11:3 3 f. 0 3 r } 
CO3? /* tat 


butters */ 

/ * d i r / d a t a h u 11 e r s * / 


(The array of BCB pointers, buf1C 3, which has the linkable name .but!, 

m u s t b e a g 1 o b a 1 1 a h e 1 . 11 w i 11 b e 1 i n k e d w i t h t h e B E M D 0 S (t m) o b j e e t 

modules.) 


I n v o k e o s i n i t () (o r ' o s i n i t ’ f r o rn a s s e m b 1 e r ) . 

P e r f cd r m B D □ S D 8 e t D r v (d e f a u 11 d r i v e) v i a T R A P # 1 . 
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7 « I f C L I i nil. t o b e e k 0 c u 1 0 d n o r m a 1 i y (t h a t i s , i o a c:l 0 d f r o rn d i s k a n d 

executed)s 

P 0 r i ;: o r m 8 D 0 8 P E x 0 c (0 n c o m m ax n d «prg H " %" p a t h = d 0 f a u 11 p a t hi \ 0 15 ) 

via TRAP # 1 * 

E ]. s 0 , t o 0 x 0 c: u t e ax i i n k 0 d i n C LI s 

* I n c 1 u d 0 t h e rn 0 d u i e s C 0 M A. 0 , a n d C 0 M M A N D« O , at n d L M LJ L« 0 w h 0 n .1. i n k :i. n g 
the system,, 

-x- p e r f q r rn B D 0 8 P _ Exec (5 , ,,n , u , u H ) v i ax T R A P # i , w h i c h r 0 1 u r n s t h e 

a d d r 0 s s 0 f a p a r t i ax 11 y i n i t i a I i z 0 d h a s 0 p a g 0 „ 

* M 0 v 0 t h 0 at d d r 0 s s 0 f c: l i () (t h a t :i. s , _ c 1 i > 1 0 b a s 0 p ax g 0 •+• p.t b a s 0 

( 8 ) ,, 

* P&rior m BDOS P_Exec ( 4, 55 ” , M M 9 "path-default.path\O n ) u 

L i n k i n g t h e C LI w i t h t h 0 s y s 1 0 m i m a g 0 a 11 0 w s n 0 w t y p 0 s 0 f m 0 d i a t q b 0 

INIT 0c:! f r 0rri t he? c0rnmand 1 i n0 , pr 0v 1 ded t ^■| at f 0r m ax 11 i ng has at 1 r eady h00n 

done« 


Motes When the 
T i "i i. s d 0 0 s n 0 1 a f f 0 c 1 

1 i 11"? e? y s-1 0 rn i s t o 
m 0 d u 1 0 R W A10« 0 s h 0 u 1 


iii: y s 1 0 m i s I i n k e d ^ 

: t h 0 0 }::> 0 r a t i. o n 0 f 

b 0 g 0 n ev r a 1 0 d f 0 r 
L d b 0 u s e? d i n s 1 0 a d 


t h e i a b 0 1 „ 0 S X.E.' N T 

the system. 

68 0 10 < o r s i rn i 1 a 

of RWA«O« 


i 11 b 0 u!" ! c:l 0 f 1 n 0 d « 

) hardware, the 


E n d 0 f A p p< 0 n c:i :i. x A 
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BASE PAGE FORMAT 


T a b 1 0 B -1 s h o w s 1 h e f □ r m a t o f t hi e b a s e p a g eT h e b a s e p a g e cl e s c r i b e s a 
p r o g r a m ' s a p e r a t i n g e n v i r o n rn e n t. T h e L o a d a n d E x e c u t e a P r o c e s s f u n c t i o n 
(4 B > i n i t i a 1 i z e s t h e b a s e p a g e w ^ i e n i n v o k e d t o 1 o a d a n e x e c:: u t a b i e c: o m m a n d 
file. For more details on the Load and execute a Process function and 
c: o m m a n d f i 1 e s , r e f e r t o t h e a p p r o p r i a t e s e c t i o n s o t t h i s g u i d e» 


T‘ a b 1 e B -1« B a s e P a g e F o r m a t s 0 f f s e t s a n d C o n t e n 1 1 

Of f set 

00 
04 
08 
0C 
10 
14 
18 
1C 

r* 

•«tl L/ 

ao 

the program 


N to t e t h a t a i 1 o t h e r b a s e p a g e f i e 1 d s a r e r e s e r v e d a n d n o t t o b e t a m p e r e d 

w i t h » 


E n d co f A p p 0 n cl i x B 
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ASCII AND HEXADECIMAL CONVERSIONS 


A S C11 s t a n d s f o r A rn e r i c: a n S t a n d a r d C o d e f o r I n f o r rn a t i 0 n I n 1 0 r c: h a n g 0 * T h 0 
c o d 0 c o n t a i n s 9 6 p r i n t i n g a n d 3 2 n o n - p r i n t i n g c h a r a c 1 0 r s u. s 0 id t o s t o r 0 d a t a 

o n a d i s k „ T a b I 0 C.i cl 0 f i n 0 s A S C11 s y m h 01 sT a b 1 0 C - 2 s h 0 w s t h 0 

c 0 n v 0 r s i a n s o f t h e A S C11 c h a r a c 1 0 r c 0 d e i n b i n a r y , cl 0 c i m a 1 „ a n d h 0 x a d 0 c: :i m a 1 
notat 1 ons. 




TabI 0 C™ 

■1. ASCII Symbols 


Symbol i v 

lean i ng 

Symbol 

ACK 

acknowledge 

FS 

f i 1 0 s 0 p a r a 10 r 

BEL 

bell 

GS 

g r 0 u p s 0 p a r a 10 r 

BS 

backspace 

HI 

I"! 0 r i z 0 n t a 1 t a b u 1 a t i 0 n 

CAN 

cancel 

L.F 

1 ine feed 

CR 

c a r i"' i a g 0 r 01 u r n 

NAK 

n e g a t i v e a c k n 0 w 1 0 d g 0 

DC 

d e v i c 0 c 0 n t r 01 

NUL 

nul 1 

DEL 

delete 

R S 

r e c c::$ r d s 0 p a r a 10 r 

DLE 

d a t a 1 i n k 0 s c a p e 

81 

sh :i f t i n 

EM 

end of medium 

SO 

shift out 

ENQ 

enquiry 

BOH 

s t a r t 0 f h 0 a d i n g 

EOT 

0 n cl 0 f t r a n s m i s s i 

on 

bP 

ESC 

escape 

SIX 

start of text 

ETB 

0 n d 0 f t r a n s rn 1 s s i 

on 

SUB 

ETX 

end of text 

8 YN 

s y n c h r 0 n 0 u s i. d 1 0 

FF 

•form feed 

US 

VI 

u r"i i t s 0 p a r a t c:* r 
v 0 r t i c a 1 t a b u 1 a t i 0 n 
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fab 

le C-2. ASCII 

Conver 

si on 

lab 


Binary 


’Dec i mal 



He 

0000000 

o 


o 

NUL 



ooooooi 

1 


i 

S0H 

< CTRL 

-A > 

0000010 

2 


2 

SIX 

< CTRL 


OoOOO11 

3 



ETX 

< CTRL 

— fj ) 

WVV 1 y y 

4 


4 

EOT 

(CTRL 

-I) ) 

oooo ioi 

5 


r.r 

ENQ 

(CTRL 

-E) 

000013.0 

6 


6 

ACK 

(CTRL 

-F) 

oooo i i i 

”7 


7 

BEL 

(CTRL 

~G) 

y 00 I you 

8 


8 

BS 

(CTRL 

--H) 

000100i 

9 


9 

HI 

(CTRL 

™ I ) 

000 1 0 i 0 

10 


A 

LF 

(CTRL 

-J) 

00010 3.1 

11 


B 

yj 

(CTRL 

-K) 

0001 .1. 00 

3.2 


C 

FF 

(CTRL 

-L) 

0001 :l 01 

13 


D 

CE 

(CTRL 

H4> 

0001110 

14 


E 

SO 

(CTRL 

-N) 

0001111 

15 


F 

SI 

(CTRL 

-0) 

001oooo 

3.6 


10 

OLE 

(CTRL 

~P) 

UU1ouo1 

17 


i i 

DC 1 

(CTRL 

-Q) 

00100 3.0 

3.8 


12 

DC 2 

(CTRL 

-R) 

0010013. 

19 


13 

DC 3 

(CTRL 

-S) 

0010 3.00 

20 


14 

DC 4 

(CTRL 

-T) 

0010101 

21 


15 

NAK 

(CTRL 

-U) 

001013.0 

2 2 


16 

SYN 

(CTRL 

- V) 

0010111 

2 3 


17 

ETB 

(CTRL 

-W) 

0011000 

24 


18 

CAN 

(CTRL 

.... x} 

0011001 



19 

EM 

(CTRL 

- Y) 

0011010 

26 


1A 

SUB 

(CTRL 

-Z) 

0011011 

27 


IB 

ESC 

(CTRL 

-1:) 

0013.3.00 

20 


i C 

FEj 

(CTRL 

- \ > 

0011101 

29 


1D 

GS 

(CTRL 

- 1 ) 

00113.10 

30 


IE 

RS 

(CTRL 

> 

00 .till 1 

31 


IF 

US 

(CTRL 

— ) 

y1yyyyy 

•3 2 


20 

<SPACE3 
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Tab10 C—2. 

(cantinued) 


Binary 

Decimal 


010000i 

33 

21 

i 

0.1.000 i 0 

34 

• •;« 

H 

0100011 

3 5 

-"jr 

# 

0 :i. 00 i 00 

36 

24 

$ 

0 :t 00101 

37 

25 

y. 

0100110 

38 

26 

& 

0100 ill 

39 

27 


010i000 

4 0 

28 

< 

0101001 

41 

29 

) 

0101010 

42 

2 A 

* 

0101011 

43 

28 

••!•• 

010 :l. 100 

Zj. .4 

2C 

* 

0101101 

45 

2D 

- 

Old 1.1.0 

4 6 

2E 

a 

0101111 

4 7 

2F 

/ 

0110000 

48 

30 

(“j 

0110001 

49 

31 

1 

0110010 

50 


2 

0110011 

51 

3 3 

3 

0110100 

52 

34 

4 

0110101 

C -i- 

ho* 


5 

0110110 

54 

36 

6 

0110111 

jut kt 
•.J w 

37 

*7' 

011.1.000 

56 

38 

8 

0111001 

57 

39 

9 

0111010 

58 

3 A 

u 

0111011 

59 

38 

fl 

0111100 

60 

3C 


0111101 

61 

3D 

:r.:: 

0111110 

62 

3E 


011 111.1 

too* 

3F 

v 

1000000 

64 

40 



adecima 
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Table 0-2. 

(continued) 


Binary 

Dec i rnal 

Hex aciec 1 mal 

100000 i 

65 

41 

A 

i uuuu i o 

66 

42 

B 

1000011 

67 

43 

c 

1000 1 00 

6 { 3 

4 4 

D 

:i. 000 1 01 

69 

45 

E 

3.000 :l. i 0 

70 

46 

F 

1000 111 

71 

47 

G 

i oo i ooo 

7 2 

48 

H 

1001001 

73 

49 

I 

1001010 

74 

4 A 

J 

1001011 

75 

4B 

K 

1001100 

76 

4C 

L 

1001101 

77 

40 

M 

1001110 

78 

4E 

N 

1001111 

79 

4F 

0 

1 oloooo 

80 

50 

F 

1010001 

81 

51 

Q 

1010010 

82 

52 

R 

1010011 

83 

53 

S 

1010100 

84 

54 

T 

1010101 

85 

55 

U 

1010110 

86 

56 

V 

1010111 

87 

57 

w 

i o :i. l ooo 

88 

58 

X 

.1.011001 

89 

59 

V 

1011010 

90 

5 A 

z 

1011011 

91 

58 

c 

1011100 


5C 

\ 

1011101 

93 

50 


1011110 

94 

5E 


1011111 

95 

5F 


1100000 

96 

60 












i i ooooi 
. 1 . 1000 . 1 . 0 
1100011 
1100100 
1. :i oo 1 o 1 
1100110 
1100 111 
1101000 
1101001 
1101010 
110101 1 
110 . 1 . 100 
1101101 
1101110 
1101111 
111 0000 
1110001 
1110010 
1110011 
1110100 
1110101 
1110110 
1110111 
1111000 
1111001 
1111010 
1111011 
mu oo 
1111101 
1111110 
1111111 
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Table C—2. (continued) 


.6 i n a r y D e c i m a 1 H e x a d e c i m a 1 


97 

61 

a 

98 

82 

b 

q> <9 

63 

c 

100 

64 

cl 

101 

65 

e 

102 

66 

t 

i 03 

67 

g 

104 

68 

h 

105 

69 

i 

106 

6 A 

j 

107 

6 B 

k 

108 

6 C 

i 

109 

6 D 

IT*} 

110 

6 E 

n 

111 

6 F 

o 

112 

70 

P 

113 

7 :i 

q 

114 

72 

r 

115 

73 

c:. 

116 

7 4 

t 

117 

715 

u 

118 

76 

V 

119 

77 

w 

120 

78 

x 

121 

79 

y 

-j ;,i 

7 A 

z 

123 

7B 

"L 

124 

7 C 

1 

125 

7D 

s 

1 8 

7E 

■\, 

:!. 27 

7F 

DEL 
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ERROR MESSAGES 


T h i s a p p 0 n d i x I i s t s t h 0 e r r o r m e s s a g 0 0- r 0 1 u r n 0 d b y t h e i n 1 0 r n a 1 c o m p o n 0 n t s 
o t G E i i D 0 S a n d b y t h 0 G E M D 0 S p r o g r a m m 0 r ' s u t i 1 i t i 0 s. s u b s 0 c t i o n s a r 0 
a r r a n g 0 d a 1 p h a b 0 1 i c a 11 y b y t h 0 n a rn 0 o f t h 0 i n 1 0 r n a i c o rn p o n e? n t c:> r u 1 i 1 i t y „ 
E a c h s u b s 0 c t :L o n h a ib 0 r r o r rn 0 s s a g e s 1 i s 1 0 d a 1 p h a io 0 1 i c a 11 y ^ w i t h 0 x p 1 a n a t i o n s 
a n d s u g g 0 s t 0 d u s 0 r r 0 s p o n s 0 s » 


D.l. AS 68 ERROR MESSAGES 

The GEM DOS assembler, AS 66 , returns both nonfatal H diagnostic error 
messages and fatal error messages- Fatal errors stop the assembly of your 
p r o q r a rn« T h 0 r 0 a r 0 t w o t y p 0 s o f f a t a 1 0 r r c:> r s s u s e* r r 0 c o v 0 r a b 1 0 f a t a i 

0 r r o r s a n d f a t a 1 0 r r o r s i n t h 0 i n 1 0 r n a 1 1 o q i c o f A S 68 - 

D - 1 » 1 « A S 6 8 D i a g n o s t i c: E r r o r M 0 s s a q 0 s 

Diagnostic messages report errors in the syntax and context of the program 
h e ing assemb 1 ed wit h out in t err up ting assemb 1 y„ Refer t o t h 0 Mot or o 1 a 
16 - B i t M i c r o p r o c: 0 s s o r U s 0 r ' s M a n u. a 1 f o r a f u 11 d i s c u s s i o n o f t h 0 a s s e m b 1 y 
1 a n g u a g 0 s y n t a x « 

D i ag n os t i c 0r r or me? ss a q e* s ap p e ar i n t h 0 f o 11 ow i n g f or m a t s 
& 1 i n 0 n o0 r r o r m 0 s s a g 0 1 0 x t 

T h 0 a m p e r s a n d <&) i n d i c a t e? s t h1 a t t h 0 m 0 s s a g e c o rn 0 s f r o rn A S 6 £$» T h e 1 i n 0 n o,, 
i n d i c a 1 0 s t h e 1 i n 0 i n t h 0 s o u r c e c a d 0 w h 0 r 0 t h 0 0 r r cd r o c c u r r 0 d « T h 0 0 r r o r 
message text describes the error- Cd. agnostic error messages appear at the 
c o n s o 1 0 a f 1 0 r a s s 0 m b 1 y , f c:« 11 o w e d b y a m 0 s s a g 0 i n d i c a t i n g t S*”i 0 t o t a 1 n u m b 0 r 

o f 0 r r o r s - I n a p r i n t . u t h t h 0 y p r i n t o n t h & 1 i n 0 p r e c: 0 d i n g t h e r r o r .. 

Table D~i lists the AS 68 diagnostic error messages in alphabetical order. 


T a h 1 0 D 1 A S 6 B D i a g n o s t i c IT r r o r M 0 s s a g 0 s 

M e s s a g 0 M 0 a n i n g 

1 i n 0 n o.. fo a c k w a r c:l a s s i q n m 0 n t t o * 

T h e a s 1 g n rn e n t s t a 1 0 m 0 n t i n t h 0 1 i n 0 i n c:i i c a 1 0 d i 11 0 g a 11 y 

assigns the location counter (*) backward- Change the 

1 o c a t i o n c c:> u n t e? r t o a f c:? r w a r d a s s i g n m 0 n t a n cJ r 0 a s s 0 rn b 1 0 t. h e 

source fi 1 e- 








Message 

& line no. 


& line no. 


& line no. 


& line no. 


& line no 


& line no. 


& 1 i n e n o. 


& line no, 


& 1 i n e n o 
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T a h 1 e D — 1 « < c o n t i n u e c:l) 


Meaning 


bad use of symbol 

A s y m b o 1 i n t h e s o la r c e line i n d i c a t e d h a s b e e n d e f i n e? d a s 
both global and common, A symbol can be either global or 
c o m rn o n h u t n o t h o t h , D e 1 e t e o n e o f t h e d i r e c: t i v e s a n d 
r e a s s e rn b 1 e t h e s o u. r c e f i 1 e» 


c: o n s t a n t r e q u i r e cl 

A n e x p r e s s i o n c:) n t h e 1 i n e i n d i c a t e d r e q u i r e s a c o n s t a n t 
9 u p p 1 y a e: o n s t a n t a n d r e a s s e m b 1 e t h e s o u. r c: e f i 1 e. 

end statement not at end of source 
The end statement must be at the end of the source code, 
T h e e n c:l s t a t e m e n t c a n n o t b e f o 11 o w e d b y a c o m m e n t o r m o r e 

t h a n o n e c a r r :i. a g e r e t la r n „ P1 a c: e t h e e n d s t a t e rn e n t a t t h e 

e n d o f t h e s o u r c: e c o d e, f o 11 o w e d o n 1 y b y a s i n g 1 e c:: a r r i a g e 

r e t u r n , a n d r e a s s e m b 1 e t h e s o u r c e f i 1 e , 


i 11 e g a 1 a cl ci r e s s i n g m o d e 

T h e i n s t r u c t i o n o n t f t e 1 i n e i n d i c:: a t e d h a s a n i n v a 1 i cl 

a d d r e s s i ri g m oci e« P r o v i d e a v a 1 i d a d d r e s s i n g m o d e a n d 
r e a s s e rn h 1 e t h e s o u r c: e f i 1 e. 

i 11 e g a 1 c o n s t a n t 

T h e 1 i n e :i n d i c: a t e d c o n t a i n s a n i 11 e g a 1 c o n s t a n t.. 8 u p p 1 y at 

va 1 i d constant and reassemb 1 e the source f i 1 e. 


i11egal expr 

T hi e 1 i n e i n d i c: a t e d c: o n t a i n s a n i 11 e g a 1 e x p r e s s i o n . C o r r e c t 

t h e e x p r e s s i o n a n d r e a s s e rn b 1 e t h e s o u r c e f i 1 e. 

i 11 eg a1 ex t ern a 1 

T h e line i ri d i c a t e d i 1 1 e gall y c o n t a i n s a n e? x t & r n a 1 r e f e r e n c: e 
to an 8-bit quantity. Rewrite the source code to define 
t h e r e f e r e ri c e 1 o call y o r u s e a 16 - b i t r e f e r e n c:: e a n cl 

r e a s s e m b 1 e t h e s o la r c e f i 1 e . 


i11egal format 

A n e x p r e s s i o n o r i n s t r u c t i o n i n t h e 1 i n e i n d i c:: a t e cl i s 
i 11 e g a 11 y f o r rn a 11 e d „ E x a m i n e t h e 1 i n e. R e f o r m a t w h i e r e 

n e c: e s s a r y a n d r e a s s e rn b 1 e t h e s o u r c e f i 1 e« 

i 11 e g a 1 i n d e x r e g i s t e r 

The 1 i ne i ndi cated contai ns an i rival i d i ndex regi ster . 
9 la p p 1 y a v a 1 i d r e g i s t e r a n d r e a s s e m b 1 e t h e s o u r c e f i 1 e „ 
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TabIe D—I« < coniinued ) 

11 e s s a g e M e a n i n g 


& 1ine no„ ill eq a1 re1 ative ad d r ess 

A n a d d r e s s i n g m o d e s p e c: i t i © d i s n □ t v a 1 i d f o r t h e 
.1 n s t r u c t i o n i n t h e 1 i n © i n die a t © d » R e f e r t o t h e M o t o r o 1 a 
16 — B i t M i c r o p r o c; e s s o r LJ s e r ; s 11 a n u a 1 f o r v a 1 i d r e g i s t e r 
rn o d e s f o r t h e s p e c i f i e d i n s t r u c: t i o n.. R e w r i t e t h e s a u r c e 

c o d 0 t. o Li s © a v a 1 i d rn o d © a n d r e a s s © rn b 1 e t h © t ile» 

& 1 :L n e n o. i 1 X e g a 1 s h i 11 c o u n fc 

T h © i n s t r li c 11 o n i n t h e i i n © i n d i c. a t e d s h i 11 s a q li a n t i t y 
m o r © t h a n 31 t i rn © s • 11 o d i f y t h e s o u. r c e c d d e t o c o r r e c t t h e 

© r r o r a n d r © a s s e rn b 1 e t h e s o u r c e f i I e „ 

& 1 :i. n e n o» i X 1 e g a X s i z © 

T h e i n s t r u. c t i o n i n t h e X i n © i n d i c a t © d r © q u i r © s o n © o f t h © 

•f o ]. X o w i n g t h r e e s :L z e s p e c i f i c: a t i. o n s s b (b y t e ) , w (w o r d > , 

o r X < X o n g w o r d) . S p p 1 y t h e c: o r r e c t s i z e s p e c i t :i. c a t i o n a r i d 

r © a s s © m b X © t h e s o u r c e f i 1 e« 

J. i n 0 n o „ i X X e g a X s t r i n g 

T h e X i n 0 i n d i c a 1 0 d c o n t a i n s a n i X X e g a X s t r i n g „ E x a m i n 0 t h e 

X i n 0 „ C cd r r © c t t h © s t r i n g a n d r 0 a s s 0 m b 1 0 t h 0 s a u r c 0 -f i X 0 . 

& X i n e n o« i X X e g a X 1 0 x t d 0 1 i m i 1 0 r 

T h 0 1 0 x t d 0 X i rn i 1 0 r i n t h 0 X i n 0 i n d i c: a 1 0 d 3 . s i n t h 0 w 1 r o n g 

•f q r m a t. U s © s :i. n g X e q u o 1 0 s ( J t © x t ‘ > o d o u b X 0 q u o 1 0 s 

( 11 1 0 x t' f ) t cd d 0 X i rn i t t h e? 1 0 x t a n d r 0 a s s 0 rn h 1 0 t h © cd u r c © 

*f i X ©» 

A X i n 0 n □ „ i X X 0 g a X 8.b i t d i 0 p 1 a c: 0 m 0 n t 

T h 0 X i n 0 i n d i. c a t e d i 1 X e g a X 1 y c o n t a i n s a d i. 0 p X a c 0 rn 0 n t X a r * g © r 

than 8-bits.. Modify the code and reassemble the source 
■f i X 0 .. 

& 1 i n 0 n o.. i 1 X 0 g a X 3 - h 11 i rn rn © d i a 1 0 

T h 0 X i n 0 i n c:l 1 c a 1 0 d i X X 0 g a X X y c cd n t a i n s a n i m m © d i a 1 0 o p 0 r a n d 

larger than 8-bits. Use the 16- or 32-bit form of the 

1 n s-1 r t.i c t i cd n a n d r 0 a s s 0 m h X e t h 0 s o u r c cd f : i X 0 „ 

& 1 i n 0 n cd » ill 0 g a 1 16 - b i t d i s p X a c © m 0 n t 

T I" ! 0 X i n 0 i n d i c a t cd d i X 1 0 g a X X y c o n t a i n s a d i s p X a c 0 rn 0 n t X a r g e r 
t hi a n X 6 - b i t s« 11 o d i f y t h e c: o d 0 a n d r 0 a s s e m b X e t h e cd u r c e 

f :i. 1 0 .. 

& X i n 0 n o.. i X X 0 g a X 16 - bit i m rn 0 cl a a t © 

T h 0 X i n cd i n d i c a t e d i X 1 cd q a X X y c o n t a i n s a n i m rn 0 cl 1 a 1 0 o p e r a n d 

X a r g 0 r t h a n i 6 - b i t s» U s e t h e 3 2 •■••• bit f o r rn o f t h e 

i n s t r i.i c t i o n a n d r cd a s s 0 rn h X 0 t h e* s o li r c 0 f i X e u 










v; 
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T a b 1 0 I) -1 m (c o n t i n u 0 d) 

M 0 s s a g 0 M e a n i n g 

& 1 i n e n o „ i n v a 1 i d d a t a I i s t 

0 n 0 d r rn o r e 0 n t r i 0 s i n t h 0 

i s i n v a 1 i d* E_ x a rn i n 0 t h e 

R e p 1 a c 0 i t w :i. t h a v a I x d 

f i 1 e« 

& 1 x n 0 n 0 „ 1n v a I i c:l 

The first 
i rival i d » 

•f i 1 0 ,, 

&: 1 :i. rn 0 n o« i n v a 1 i d x n s t r u c: t i o n 1 0 n g t h 

7 h 0 i n s t r u c t i o n x n t h 0 1 i n 0 x n d i c a 1 0 d r 0 q u 3 . r e s o n 0 a t t h 0 

•f d i 1 o w i n g t h r 0 0 s i z e* s p e c i t i c: a t i o n 0 s b < b y 1 0) , w < w o r d ) , 

o r 1 < 1 o n g w o r d) « S u. p p 1 y t h 0 c o r r e c t s i z e s p 0 c i. t i c a t i o n a n d 

r 0 a s s 0 rn b 1 0 t h e s o u r c 0 f i 1 0„ 

& 1 i. n e n oi n v a 1 :L d 1 a b 0 1 

A r 0 q li i r 0 d o p 0 r a n d i s n o t p r 0 s e n t x n t h e* I x n 0 i n d i c a 1 0 d , , o r 
a 1 a h 0 1 r e f 0 r 0 n c 0 i n t h e 1 1 n 0 i s n o t x n t h 0 c 0 r r 0 c t f o r m a t. 
S u p p 1 y a v a 1 i d i a b 0 1 a n d r 0 a s s 0 rn b 1 0 t h 0 s o u r c 0 -f i 1 e. 

1 i n 0 n o,, i n v a 1 i d o j::« c o d 0 

T h 0 o p c 0 ci 0 i n t h 0 1 i n 0 i n dica t & d i s n 0 n.0 k i 0 1 0 n t c:) r‘ 

i n v a 1 i. cl. S u p p I y a v a 1 i d 0 p c 0 d e a n d r 0 a s s 0 m b 1 e? t h 0 s cd li r c e 

•f i 1 0 a 

h 1 i n 0 n u 3. n v a i i d 0 0 c 0 n d 0 p 0 r a n d 

T h 0 s 0 c: 0 n c:l 0 p e: r a n d 1 n a n 0 x p r 0 0 0 i 0 n i n t h e-? I i n 0 i n d i c: a 1 0 d 

i s i n v a I i d« S u p p . 1 . y a v a 1 i d 0 p e r a n d a n d r 0 a s s e m b I e t li e? 

source f i 1 

0/ :i i n 0 ri 0 „ 1 a b e 1 r 0 d 0 f 1 n 0 d 

T h i s rn 0 s s a q & i r"i d i e: a 1 0 s- t h a t a I a b 0 1 h a s b 0 0 n d 0 i i n 0 d t w i c:: 0 „ 

7 h e s 0 c 0 n d d 0 1 i n i 1 3.0 n o c c u r s :L n t h 0 1 3. n 0 i n d i c a 1 0 d « 

R 0 w r i 1 0 t h 0 s o la r c ea c: o d 0 1 0 s p 0 c: i t y a la n i q u 0 1 a b 0 1 1 0 r 0 at c: h 

d 0 f i n i t i 0 n a n <:i r 0 a s s 0 m b 1 0 t h 0 s 0 u r c 0 f i 1 0 „ 

^ I x n 0 n 0 „ rn i s s i n q ) 

A n 0 x p r 0 x o n x n t h 0 I x n 0 x n d x c a t d i s m x s s x n g a r x g h t 
p a r g* n t h 0 s i 0« S u p p 1 y t h 0 m i s s x n g p a r e n t h 0 s i s a n d re a s s e rn b 1 0 

t h g? s cj la r c 0 f x 1 „ 

& 1 3. n 0 n 0 *t n 0 1 a Id 0 J. t o r 0 p 0 r a n d 

A n 0 p 0 r a n d i r"i t h 0 1 ine x n d x c a 1 0 d x s m i s s i n g a I a b 0 1 „ 

8 u p p I y a 1 a b 0 1 a n ?d r 0 a s s 0 m b 1 0 t h e s o u r c 0 f i 1 0 „ 


tx rst operand 

0 p 0 r a n c j :i. n a n e x p r 0 s i cx n x r i t h 0 1 x n e x n c:i i c at 1 0 ci x s 
'8 u p p 1 y a v a 1 x d 0 p e r a n d at n d r 0 a s s 0 m b 1 0 t h 0 s 0 u r c 0 


d a t a I x s 1 x n t h 0 I i n e 1 n d x c: a 1 e* ci 
1 :i. n 0 f 0 r t h 0 i n v a I x d 0 n t r y „ 
0 n t r y a n d r a s s 0 rn b 1 0 t h 0 s 0 u r c:: 0 









6 e m D o s D o c u m 0 n t a t i o n 
S 0 r i a 1 N u m b e r 006738 


Tab 1 0 D 1 « (c on ti n ued) 


M 0 s s a g 0 li 0 a n :i. n g 


& 1 i n 0 n 0 1: 0 p c: 0 d 0 r 0 d 0 f :i. n 0 d 

A 1 a b 0 1 i n t h 0 I i n 0 i n d i c a 1 0 d h a s t h 0 s a rn e m n 0 m 0 n :i. c s a s a 

p r 0 v i o u s 1 y s p e c i t i 0 (.1 0 p c a d 0« R 0 s p 0 c i f y t h 0 I a b 0 1 s 0 t hi a t 

:i. t d 0 0 s n 0 1 I" ? a v e t h 0 s a rn 0 s p 0 11 i n q a s t h 0 m n e rn 0 n i c: f 0 r t h 0 
o p c: o d 0 „ R e? a s s 0 m b 1 0 t h 0 s 0 u r c 0 f i 1 0. 

& 1 i n 0 n 0„ r 0 g i s 1 0 r r e q u :i. r 0 d 

T h © i n s t r u. c t i 0 n i n t h e 1 i n 0 i n d i c a t e? d r 0 q u i r e s 01 1 hi 0 r a 
s o u r c 0 o r d 0 s t .1 n a t i a n r 0 g 1 s 1 0 r » S u p p 1 y t h e a p p r 0 p r i a 1 0 
r 0 g i s 1 0 r a n d r 0 a s s 0 rn b I 0 t hi e s 0 u r c 0 f i 1 0 „ 

6 : 1 i n 0 n cd « r 0 1 0 c a t i 0 n 0 r r o r 

A n 0 x p r 0 © s i o n i n t h 0 1 i n e- i n d i c a 1 0 d c o n t a i n s m 0 r 0 t h a n o n e 
0 k 1 0 r n a 11 y d 0 -f i n 0 d g 1 0 h a i s y rn b 0 1 . R 0 w r i 1 0 t h 0 o u r c 0 c: o d 0« 
Either mak© one of the externally defined global symbols a 
1 0 c a 1 s y m Id q 1 , a r 0 v a 1 u a 1 0 t h 0 0 x p r e s s i 0 n w i t h i n t h e c 0 d 0« 
R e a s s e rn b 1 0 t h 0 s o u r c £•? f i 1 0 „ 


1 i n 0 n o.. s y rn b o 1 r 0 u i r e^ d 

A s t a t e rn 0 n t 1 n t 0 1 :i. n 0 1 n d i c: a t & c:l r & q u 1 r 0 a s y rn b a 1 « 

8 li pp 1 y a va 1 i d syrnb0 1 and r0ass0mb 1 0 th e s 0urc:0 f ile« 

& I i n 0 n c::« „ u n c:l 0 f i n 0 d s y m b 0 1 i n 0 c| u a 1 0 

0 n e 0 f t In 0 s y m b o 1 s i n t h 0 0 q u a 1 0 d i r 0 c t i v 0 i n t hi e 1 i n e 

1 n d 1 c: a 1 0 d i s u n cl 0 f i n d« D 0 *f : i n 0 t h 0 s y m b 0 1 a n d r 0 a sh. cs e* rn b 1 0 

t Id & s o li r c: 0 f i 1 0« 


^ 1 i n 0 n 0u n d e f i n 0 d s y rn b o 1 

T Id 0 i i n e^ i id d i c a t e d c: cd n t a i n s a n u n ci e f i n 0 d s> y m b 0 1 t h a t hi a s 
n o t h 0 0 n d 0 c 1 a r 0 d g 1 o b a 1 » E i t h 0 r cl 0 f i n 0 t h e s y m b o 1 w i t h i n 

t hi 0 rn 0 ci u 1 0 o r cl e f i n 0 11 a s a q 1 0 b a 1 s y rn b 0 1 a n ci r 0 a s s ® rn b 1 e 

t h 0 s 0 u r c. 0 f i 1 0 » 









6 0 m D 0 s D o c u rn e n t a t i o n 
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f s 


D ■ 1 « 2« U s e r - r e c o v e r a b 1 0 F a t a I E. r r o r li e s s a g e s 

a n e r r o r o c c li r s 
E. r a s e t. h e p a r t i a 1 

f x i e t d 0 n s u r 0 11”? a t y o u d o n o t t. r y t. o I :i. n k 3. t« 


Table D-2 describes fatal error messages for AS68. When 
b e c a u s e t h e d i sj k i s f u 11 , A S 6 3 c r e a t e s a p a r t i a 1 f i 1 e « 


T a b 1 e D 2 u A S 6 8 U s e r.r e c:: o v e r ab1 e F a t a 1 E r r a r li e s s a g e s 


ii e s s a q e li e a n i n g 


& c a n n o t c:: r e a t e i n i t s A868S V li B« D A T 

A 3 6 8 c a n n o t c r e a t e t h e :S. n i t i a 1 i z a t i o n f i 1 e b e c a u s e t h e p a t h 

n a m e i s i n c o r r e c: t a r t h e d i s k t o w h i c h i t w a s w r i t i n g t h e 

f i 1 e i s f u 11 .. 1 f y ou u.se d t h e — S s w i t c h t o r e cl i r e c t t h e 

s y m b o 1 t a b 1 e t o a n o t h e r d :i s k , c: h e c.:: T: t h e p a t h n a m e» I f i t 

i s c:orr ect, 1 he cl :i. sk :i. s f u 11 « Erase unnece*ssar y f i 1 es , i f 

a n y ? o r i n s e r t a n e w d i s k b e f o r e y o u r e i n i t i a 1 i z e A 8 6 8« 

E r a s e t h e p a r i i a 1 f i 1 e t h a t w a s c r e a t e d o n t h e f u 11 d i s k t o 

e n s u r e t li a t y o u d o n o t t r y t o 1 i n k i t« 

& e x p r o p s1 k o v e r f 1 o w 

A n e x p r e s s i o n 1 n t h e 1 i n e i n d i c a 1 e cl c: o n t a i n s t o o m a n y 

o p e r a t i o ii s f o r 1h e o p e r a t i o n s s t a c k « S i m p 1 i f y t h e 

e x p r e s s i o n b e f o r e y o u r e a s s e m b 1 e t h e s o u r c: e c o d e. 

& e x p r t r e e o v e r f 1 o w 

T h e e x p r e s s :i. o n t r e e c:i o e s n o t h ax v e s p a c: e f o r t h e n u m b e r o f 

t e r m s :i n o ii e o f t h e e x p r e s s i o n s :i n t h e i n d x c a t e d 1 x n e o f 

s o u r c: e c: o d e. R e w r x t e t h e e x p r e s s i □ n 1 o u s e f e w e r t e r m s 

b e f o r e y o u r e a s s e m b 1 e t h e s o u r c: e f i 1 e« 

& I / 0 e r r o r o n 1 o a d e r o u t p u t f i 1 e 

T ii e cl i s k t o w h i c:: h A S 6 8 w a s w r i t i n g t h e 1 o a d 0 r a u t p u t f i 1 0 
i <:=• f u 11 „ A368 w r o 1 0 a p a r t i a 1 t x 1 0 « E r a s 0 u ii ii 0 c 0 s s a r y 

f i 1 e s <{ i f a n y h o r i n s r t a n e w d i s k a n d r 0 a s s 0 m b 1 e t h 0 

s o u r c 0 f i 1 0 « E r a s 0 t h 0 p a r t i a 1 f x 1 0 t li a t w a s c r 0 a 1 0 d o n 

th 0 f u 11 d x s k to ensu.r 0 t hat you d o not tr y t o 11 n k i t „ 

«<•: 1 / 0 wr i 1 0 er r or on i t t x 1 0 

Th 0 d x sk t o wh i c:h AS68 was wr i t i ng t h 0 x n t er med x ate tex t 
f i 1 0 i. s f u 11 « A868 w r o 1 0 a p a r t i a 1 f i 1 0 . E r a s 0 

u r 1 n e c: 0 s s a r y f i 1 0 s , i f a n y , o r i n s 0 r t a n 0 w d i s k a n d 

reassemble the source fxle„ {'Erase the partial file that 
was created on the full disk to ensure that you do not try 
t o 1 i n k i t» 

2 i t r e a d 0 r r o r 11 o f f s 0 1 n o „ 

T T i e c:i i s k t o w h i c: h A868 w a s w r i t i n q t h e i n t e r m e cl 1 a t e 1 0 x t 

f i 1 e i is f u 11 „ A S 6 8 w r o t e a p a r t i a 1 f :i. 1 e» T h 0 v a r x a h e 

11 o f f s 0 1 - n o „ i n cl i c a 1 0 s t h 0 f i r s t z 0 r o - r 0 1 a t i v 0 b» y 1 0 n u m b e r 
n o t r 0 a d . E r a s 0 u n i"i 0 c 0 s s a r y f i 1 0 s 9 i f a n y 9 o r x ii s e r t a n 0 w 

d i s k a n d r 0 a s s 0 rn h 1 0 t h 0 s o u r c: 0 f i 1 e „ E r a s 0 t h 0 p a r t i a 1 

•f i 1 0 t h a t w a s c r e a 1 0 d o n t h e f u 11 d i s k t o 0 n s u r 0 t hi a t y o u 

cl o n o t t r y t o i 1 n k i t „ 
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T a b 1 e D 2 „ (c. o n t i n u. e d > 


age lieani ng 


0 b j 0 c t Y i 1 e w r i 1 0 0 r r 0 r 

T h0 d i sk t o wh i ch A 56 £$ was wr i t i ng t he ob j ec t f i 1 0 i s Y li 1 I „ 

A 8 6 8 w r o t0 a p a r t i a 1 f i 1 e „ E r a s 0 u n n e c 0 s s a r y f i 1 0 s , i f 
a n y * o r :i. n s e r t a n 0 w d i s k a n d r 0 a s s 0 m b I e t h 0 s o u r c 0 t i 1 0» 
E r a s0 11 "; 0 p a r t i a 1 Y i 1 0 t hi a t w a s c r 0 a 1 0 d on t h 0 Y u 1 i d i s k t o 

0 n s u r 0 t h a t y o u d o n o t t r y t o 1 i n k i t 

a v 0 r f j. o w o f 0 x t0 r n a 1 t a b 1 0 

T h 0 b o u r c: 0 c o d e u b © b t o o m a ri y 0 x 1 0 r n a 11 y d 0Y i n 0 d g 1 o b a 1 

s y m b a 1 s f o r t h 0 s i z 0 o f t h 0 0 x 1 0 r n a 1 s y m b 0 1 t a b 1 0« 

E 1 i rn i n a 1 0 b 0 m 0 0 x t. e r n a 1 J. y d © Y i n 0 d g 1 o b a 1 s y rn b o I s a n d 

r 0 a s s 0 rn b 1 0 t h 0 s o u r c 0 f ile. 

R 0 a d E r r 0 r 0 n I n t e r rn e d 1 a 1 0 F i I 0 s A 8 X X X X n 

T h 0 d i s k 1 0 w h i c hi A 868 w a s w r i 1 3. n g t h 0 3. n 1 0 r m 0 d i a 1 0 t0 x t 

Y i i 0 A 8 X X X X i s f u 11 « A S 6 8 w r 0 1 0 a p ax r t i a 1 Y i 1 ©. T h 0 

v a r i a b 1 0 n i n ci i. c a t0 s t h 0 d r i. v 0 0 n w h i c hi A 8 X X X X i s 1 0 c: a ted., 
E r a b e u n n © c: 0 s s a r y f i 1 e s ,, i Y a n y , 0 r i n s e r t a n e w d i s k a n d 
r 0 a s b © m b I 0 t h 0 s 0 u r c: 0 f i 1 0« E r a s 0 t h 0 p a r t i. a 1 f i 1 0 t h a t 
w a s c r 0 a 1 0 d 0 n t h & i u J. 1 cl i b k 1 0 © n s u r e t h a t y 0 u d 0 n o t t r y 

t o 1 i n k i t» 


b y m b c::« I t a b 1 e 0 v 0 r 1 1 0 w 

T h e p r 0 g r a m u s 0 s 1 0 0 rn a n y s y m b 0 1 s 1 0 r t h e s y m b o 1 t a b I e» 

E ]. i m 1 n a 1 0 s o m 0 s y rn b 0 1 s b e f 0 r 0 y 0 u r e a s s 0 m b 1 0 i h 0 s 0 u r c 0 

c ocl ©« 

U n a b I 0 1 0 0 p 0 n f i 1 0 *f i 1 0 n a m 0 

T l"‘i 0 s 0 u r c 0 f 11 © n a rn 0 :t n d i c: a t © d b y t h © v a r i a b 1 0 f i 1 0 n a m 0 i s 
i n v a lid 0 r h a s a n i n v a 1 i d p a t h n a rn e * C h 0 c k t h 0 p a 11 "i n ex m 0 
a r "i cl t h 0 f i 1 © n a m 0R 0 b p 0 c: i *f : y t h 0 c: 0 m rn a n ci I i n 0 b ex f 0 r © y c:> u 

r 0 a s 0 m b 1 0 1 1 * 1 e s 0 u r c 0 t i !l 0« 

U n a b 1 0 t a o p 0 n i n p u t -f i 1 ex 

The filename in thex command line indicated does not exist 
o r h a s a n 1 n v a 1 :i. d p a 11 "i n a m 0 „ C h 0 c k t h ex p a t h n a m 0 a n d t h 0 
f i 1 ex n a rr* 0. R 0 b p 0 c: i f y t h 0 cr. 0 m rn a n d 1 i n e b 0 f 0 r e y o u r ex a s s 0 rn b 1 0 
t hi 0 s 0 u r c 0 f i. 1 e« 


LJ r"i a b 1 0 1 0 o p 0 n 1 0 rn p o r a r y f i 1 ex 

Y o u ix liii- e cl a n i n v a 1 i d p a t h n a rn 0 0 r t h 0 cl i b k 1 0 w hi i c: h A 8 d:« 8 w a b 

w r i t i t ”i g i. s t u 11 » C h e c k t h e p a t h n a rn 0. 1 Y i t 3. s c 0 r r 0 c t 

t h ex d i b k 1 s f u. 1 1 » IE r a b ex u n n © c: © b b a r y f i 1 0 s , f i f a n y , 0 r - 

insert a new disk before you reassemble the source file. 
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T‘ a b 1 e D - 2» (c o n t i n u e ci) 


M e s s a q e l v i e a n i n g 


& U n a b 1 ex t o r e a d i n i t f i 1 e: A S 6 8 S V M B» D A T 

T h e p a t h n a m e u s e d t o s p e c i f y t h e i n i t i a 1 i z a t i o n f i i e i s 

i n v a I i d o r t h e a b b e m b 1 e r h a s n o t b e e n i n i t i a 1 i z e d« C I" ! e c k 

11 "i e p a t h n a m e« R e s p e c: i f y t h e c o m m a n d 1 i n e b e f o r e y o u 
r e a he in;. 0 n*i b 1 e t h 0 s o u r c ex t i 1 0 „ I f t h 0 a b b 0 rn b 1 0 r h a b n o t b 0 0 n 
i. n i t i a 1 i z e d , r e f 0 r t o 8 0 c: t i o n 5 t q r i n s t r u c t i o n s« 

& W r :i 1 0 0 r r o r o n 1 n i t f : i 1 e s A S 6 8 S V M BD A T 

The disk to which A868 was writing the initialization file 
i b f u. 11 „ A968 w r o 1 0 a p -a r t i a I t i 1 0 „ E r a he 0 li n n ex c e s s a r y 

•f i 1 0 s 9 i t a n y o r i n s 0 r t a n 0 w d i s k a n d r 0 a s s e m b 1 0 t h 0 

s 0 u r c 0 t i 1 e. E r ax s 0 t h 0 p a r t i a 1 f i 1 0 11 "} a t w a 0 c: r 0 ax 1 0 d o n 
t h 0 f u 11 d i s k t o e n s u r 0 t h a t y o u d o n o t t r y t o 1 i n k 1 1« 

& wr i t e sr r or on i t t i i 0 

T h 0 d i b> k 1 0 w h i c h A 8 6 8 w ax s w r i t i n q t h 0 i n t ex r m ex d i a 1 0 t ex k t i s 
t u 11 A868 w r o 1 0 ax p a r t i a 1 f :i. 1 0 » E r a s e u n n e c: 0 s s a r y t i i e he „ 
i t a n y , o r 1 n s ex r t ax n e w d i s k « E r ax s 0 t h 0 p ax r t i a 1 f i i 0 t h ax t 

w a s c r e ax t e d o n t h ex t u 1 i d i s k t o 0 n s u r e t h a t y o u d o n o t t r y 

t o i i n k i t R 0 a s s 0 rn h 1 0 t h 0 s o li r c: 0 f i 1 0 « 


D. 13 » A 868 I n 1 0 r n a 1 L o g :i. c E. r r o r M e s b a g e s 

T h ex f o 11 o w i n g a r ex m ex b he a g 0 s i n d i c a t i n g -f ax t a I e r r o r he i n t h 0 i n 1 0 r n a i I o g i c 0 1 

AS 6 8 2 

d o i t r d s h li f -f 0 r b 0 1 c h p i t i x = n n n i t b u f = n n n 0 n d n n n 
8 /. d o i i; w r s i t b u t f 0 r i:? o t c h 

i n v a I i d r ax d i x 3. n 0 c: 0 n s t 

& i«t» overt 1 ow 

& i t s y n c ex r r 0 r i 11 y ::::: n n n 

5 -: s 0 ex I**.: 0 r r 0 r o rx :i. t f i 1 0 

6 q u. t w o r d 2 fa a d r I f 1 c::j 

.[ t y o u r 0 c: ex i v e a n 0 o t t h ex he 0 rn ex he b ax q e he «« c 0 n t a c t y o u r v ex n c:l cd r -f 0 r a he b. i he t a n c 0» 

Y o u e;. !“i o u. 1 d d 0 t h 0 f o 11 o w 3 . n g 2 


* I n c:l i c a 1 0 w h :i. c: h v ex r he i o n 0 f : t h ex 0 p ex r a t i n q s y s t e m y c::» u a\ r 0 u he i n q « 

* D e ib c r i b 0 y o u r he y he 1 0 m s i t a r d w a r e c o ri t i g u r a 1 1 o n „ 

* P r o v i 0 0 he u f t i c: :i. 0 n t i n 1 0 r rn ax t i 0 n t c* r 0 p r 0 d u. c: 0 t h 0 0 r r 0 r » j.' n d i c ax t e w h i c: h 

p r o g !-■ a rn w a he r u n n 1 n g a t t h 0 t i. rn e t h ex ex r r o r o c c u r r ex d , I f p o he b :t b 1 ex , y 0 u 

he I") 0 li 1 d a i he 0 p r o v i d 0 a d i he k w i t h a c o p y o f t h 0 p r 0 g r a rn „ 
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Dn2« L..068 ERROR MESSAGES 


The GEM DOS Linker, 
d i a g n o s t i c a n d 1 o g x c « 
f o i I o w i n g f o r m a t s 


L 0 6 b h r e t u r n s t w o t y p e s o f f a t a I e r r o r rn e s s a q e s 5 
B o t h t y p e s o f f a t a 1 e r r o r m e s s a g e s h a v e t h e 


: e r r o r rn e s s a g e t e k t 

T h e c: d 1 o n <n ) i n d i c: a t e s t h a t t h e e r r o r rn e s s a q e e o rn e s f r o m L 0 6 8.. T h e r ’& r r o r 

m e s s a g e fc e x t 15 d e s c r i. b e s t h e e r r o r« 


D „ 2 „ i „ F a t a 1 D i a g n o s t i c: E r r o r M e s s a g e s 


A f a t a 1 d 1 a g n o s t i c s r r o r p r e v e n t s y o u r p r o g r a m f r ex rn I i n k i n g . 

e r r □ r i s c a u s e d b y a f li 11 d i s k , e r a b e t h e p a r t i a 1 f i 1 e t h a t L 0 6 3 

t h e d i s k t h a t r e c e i v e d t h e e r r o r t o e n s u r e t h a t y o u d o n o t u s e 

T h e 1... 0 6 E* d i a g n o b t i c: e r r o r s a r e 1 i s i ed i n T a b i e D— 3 i n a 1 p h a b e t i c 

e x p 1 a n a t i o n s a n d s li g g e s t e d u s e r r e s p ex n s ox? s» 


When the 
created on 
the fi1e„ 
order with 


T a b 1 e D—3« L06 3 F a t a 1 L> i a q n o s t i c: E r r o r M e s s a g e s 

M e e> s a g e M e a n :i. n g 


s d up J. x c at e d ef i n i t x on i n p f i i en a me 

T h e s y rn b o I x n d x c a 1 e d b y t h e v a r i a; bI e p i s c:l e f 1 n e d t w i c: e« 

T h e v a r i a b 1 e f .i. 1 e n a rn e i n d 1 c a t e s t h e f i. 1 e i n w h x c h t h e 

sec: ond de f i n x t x on oc: cur r ed „ Rewr i t e t he sour c e c ode« 

P r o v 1 d e a u n i q u e d e f x n i t i o n f o r e a c h s y m b o 1 a n d r e a s s e rn b 1 e 
o r r e c: o rn p x 1 e t h e o u r c: e c: o d e b e f o r e y ex u r e i i n k t h e i ;; i 1 e» 

s f :i. I e f o r rn a t e r r o r t i 1 e n a m e 

T i" i e i i i e x n ci x c:: a t e d b y t h e v a r i a b i e t i 1 ex rt a m e x s e i t h e r n o t 

a n o b j e c t f i 1 e o r t h e t i i e h a s b e e n c o r r u p t e d » E n ib u r e 11', a t 

t h e t x 1 e 1 s a n o h. j ex c t f x 1 ex „ o u t p u t b y t h e a s s e m b 1 e r o r 

c amp i 1 er Reassemb 1 e or r exc ornp i 1 e t h e f i 1 e b ef or ex you 

r e 1 x n k x t« 

s i ::: ' i 1 e F o r rn a t E r r o r s I n v a 1 i d s y rn h o i f 1 a g s f 1 ex g s 

L068 d o e s n o t r ex c: o g n i xr ex t h e s y m b o 1 f 1 a g s i n d i c a t e d b y t h ex 
v a r x a b I ex f 1 a g s«. T i'"i e f i 1 e L068 r e a d x s ex i t h ex r n o t a n o b j e c:: t 
file or has been corrupted. Ensure that the file is an 
o b j ex c t f i 1 e ^ cx u t p u t b y t h ex a s s e rn b J. ex r o r c o m p :i. 1 e r . 
R ox a s ib ex m b 1 ex o r r e c o m p i 1 ex t h ex f i 1 e h e f o r ex y o u r ox 1 :i. n k i t« 

s F i I ex F o r rn a i: E r r o r s i n v a i i ci r ex 1 o c: a t x o n f i a g i n f i I e n a m ox 

The contents of the file indicated by the variable filename 
a r e i s** i c o r r e c: 11 y f o r rn ax 11 e d« T h ox 1 : x 1 & e? :i. t h ex r i n o t a n 

o b. j e c t f i 1 ex ex r h a s b ex ox? n c: ex r r - u p t ox? d » E n s u r e t h a t t h e f 11 ox x ob 
a n o t) j ex c: t f i 1 ox , o u t p u t b y 1 h ex a s s ex m b 1 e r cx r c o m p i 1 ex r , I f 
t h ex f :i. 1 e x s a n ex b j ex c t f i 1 ox? b u t t h i s ox r r o r ex c c u r s , t f i ex f x 1 ox 
h a s b ex e n c: o r r u p t e d. R ex a*, s s ex rn h i e o r r ex c: o rn p i 1 ox t h e f i 1 ox 

b ox f o r ex y o u. r ox 1 x n k i t» 
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T a b 1 e D 3« (c o n 1 1 n u e d) 


i v i e s s a g s M e a n i n g 


s F i I e F o r m a t E r r o r n n o r e 1 o e ax t i o n b 1 1 s i n t i 1 b n a m e 

7e f i 1 e i n d i c a t e d h y t Fx e v a r i a b 1 e f i X e n a rn e e i t h e r i s rx o t 

a rx o b j e c: t f :i. 1 e o r h a s b e e rx c o r r u p t e d» E rx s u r e t h ax t t h e f i 1 e 
i s ax rx o h. j e c fc f i 1 e , o u t p u t fo y t h e a s s e nx b 1 e r o r c o rn p i 1 e r » I f 
t h e t i 1 e i s a rx o b j e c t t i 1 & b u t t h i s e r r o r o c: c u. r s t h e r x t h e 
f i 1 e h a s b e e r x c o r r u p t e d . E e ax s s e m b 1 e a r r e c a rn p i 1 e t h e f i X e 
b e f o r e y o u r e 1 i rx k i t« 

s X I1 e g a 1 o p t :i c:« rx p 

T h e o p t i o rx i rx t h e z: o m m ax rx d i i rx e i rx d i c: ax t e? d b y t h e v ax r i a b 1 e p 

i s i rx v ax 1 i d« 8 u p p 1 y a v a 1 i d o p t i o rx ax rx d r e 1 i r x k » 

s I r x v a I i d J. o 6 Q ax r q u rn e rx t J. i s t 

T h i s rn e s s a g e i rx d i c a t e s f o r nx ax t e r r o r s o r i rx v ax I i d a p t i o rx s i rx 

t h 0 c q nx rn a rx d 1 i n eE x a rn i rx e t h e c o nx rn a rx d 1 i rx e t o 1o c: ax t. e t h e 

0 r r d r « C o r r e c: t t h e e r r o r a r x d r e 1 i r x k » 

a o u fc p u t t i 1 e w r i t e e r r o r 

T h e d i a:, k t o w Ii 1 c Fx L068 i s w r i t i rx g is f u 11 « E r ax s e 

u n rx 0 c e s s a r y f i 1 e s , x f a rx y 9 o r i rx s 0 r t a rx e w d i. s k b e f o r e y o u 

r e r x t e r t Fx e L.. 0 6 fB c:: o rn m a rx d i i rx ©» 

s r e ax d a r r cx r o rx f i. 1 ©:: f i 1 e rx a nx 0 

T Fx © 0 b j 0 c: t f i 1 e i rx d i c a 1 0 d b y t Fx 0 v a r i ax b i e t x 1 e r x a m 0 c:l 0 0 s n 0 1 
h a v e e rx o u g h b y 1 0 s« T h 0 t i 1 0 0 i t. h 0 r .i. ib i rx c o r r e-? c: 11 y 

•f 0 r rn ax 11 © d 0 r Fx a s b b © rx c: 0 r r u p 1 0 d „ T Fx i s 0 r r cx r i s c c;> nx m 0 rx i y 
caused when the input to L068 is ax partially assembled or 
c 0 rn p x 1 e d 0 b j e c 1 t i 1 e» T Fx 0 a s s e rn b 1 0 r „ A S 6 8, a n d s 0 m 0 
c: o nx p i 1 0 r s c r 0 a 1 0 }:x ax r t i a 1 o b j 0 c t f i 1 0 s w Fx 0 n t h 0 y r 0 c 0 i v 0 t Fx 0 
d i s k t u 1 1 ax Fx 0 r t rn © s s a g e w Fx x J. b b s s b rn b 1 i rx g c::« r c: o m p x 1 i rx g ax 

•f i 1 0 « E n s u r e t Fx a t t h © f i 1 © x s ax c o rn p 1 0 1 0 a b. j 0 e t t i 1 0 « 

R 0 ax s s b rn h 1 © cx r r © c c:j nx p i 1 0 1 Fx e 1 1 1 © b 0 1 cx r e y 0 u. r © 1 x rx k x t „ 

ii s y m b o 1 t a b 1 0 0 v © r f 1 a w 

T Fx e c:x b j e c t c:: 0 ci 0 c 0 n t a i rx s 1 0 cx nx ax rx y s y rn fo o i s 1 0 r t Fx © s i 2 e cx t 

t h 0 s y rn i:x cx 1 t a b 1 0 , R 0 w r i t e t Fx 0 cs o u r c 0 c o d 0 t o u s 0 f e w © r 

s y rn to 0 1 s- „ i :: < 0 a s s e rn fo 1 © 0 r r 0 c 0 m p i 1 e t Fx © s 0 u r c: 0 c c:«d 0 tx 0 f cx r* © 
y o u r 0 1 i n !•-: t Fx 0 t i 1 0 ■ 

s L J n a b 1 © 1 0 c r © ax t © p ax t h n ax rn e 

T Fx 0 0 u t p u t t i 1 e i n d i c a 1 0 d b y p ax t Fx rx ax m © Fx ax s a n i rx v ax 1 i d p a t Fx 

n a rn 0 ,, 0 r t h 0 d i s k t o w Fx x c Fx L068 x s w r i t x n g i s t u 11 C h 0 c F: 

t Fx e p at h rx am©« I f i t x s c or r ec t, t Fx e d i s k i s t u 11 .. Er as© 

u. r x rx 0 c 0 s s a r y -f i 1 0 s , i f a n y , 0 r i r x s 0 r t a n 0 w cJ i. s k b e t o r 0 y c> u 

r 0 0 rx 1 0 r t Fx 0 L068 c: 0 nx rn a n d 1 i rx e« 
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T a b I e D - 3 « (c a n 1 1 n u e d ) 


M e s s a g e H e a n i. n g 


s u n a b 1 e t o o p a n f i 1 a n a rn e 

T h e f i I e n a rn a i n ci i c a t e d b y t h e v a r i a b 1 e f i 1 0 n a m a i s i n v a 1 i d 

or th0 fi 1 e does not exist* Check th0 fiiename betore you 

r 0 e n 1 0 r t h 0 L 068 c : o rn m a n d 1 i n 0« 

« LJ n a fo 1 0 t o o p 0 n 1 0 m p o r a r y t i 1 0 s p a t h n a m 0 

E i t hi 0 r th 0 t i 1 0 i n d i c a 1 0 d b y p a t h n a rn 0 9 h a s a n 1 n v a 1 :i. d 
cl r i v 0 c o d 0 i n t b 0 p a t h n a rn 0 ? s p 0 c i f i 0 cl b y t h e t o p t i o n ,, o r 
1 h 0 d i s k t o w h i c h L 068 i s w r i t i n q i s t u 1 1 « C I"10 c k t h 0 p a t h 
n a m 0„ I f i t 1 s c o r r 0 c t, t h 0 d 1 s k i s t u 11 « E r a s 0 

u n n 0 c 0 s ci- a r y f i 1 0 s :i. f a n y , o r :i. n s e r t a n 0 w d 1 s k b 0 f o r 0 y o u 

r 0 0 n 1 0 r t h 0 L 068 c o rn m a n d 1 3. n 0 

s: U n ci 0f :i. n 0 d s y m b o 1 («>) 

T h 0 s y H i b o I o r s y rn h o 1 s w h i c h a r 0 1 i s 1 0 cl o n 0 p 0 r I i n 0 

f o i 1 o w 1 n g t hi 0 0 r r o r m 0 s s a g 62 ax r 0 u ni 0 f 1 n 0 d « P r o v 1 d 0 ax v ax 1 x d 
d 0 f i n i t :i o n a n d r 0 a s s 0 rn b i 0 t hi 0 s o u r c: e c o d 0 b 0 1 o r 0 y o u. 

r 0 0 n 1 0 r t h 0 L 068 c o m m a n d 1 i n 0« 


D» 2 » 2 . L 068 Internal Logic: Error Messages 

T h x s s 0 c t x o n 1 i s t s m 0 s s a g 0 s i n d x c ax t x n g f a t a 1 0 r r o r s x n t h 0 x n t e r n a 1 I o g i c 

a t L 060 » 1 f y o li r 0 c: 0 i v 0 o n 0 o f t h 0 s 0 m 0 s s a q 0 s ^ c: o n t a c: t t h 0 p J. a c: 0 y o u. 

p u r c: h a s 0 d y o u. r s y s 1 0 rn f o r a s s x s t ax n c 0» Y o u s h o u 1 d cl o t h 0 + o 11 o w x n g r, 


I n d x c a 1 0 w h i c::: h v 0 r i cd n o t i: h 0 o p 0 r a 11 n g s y s 1 0 m y o u a r 0 u s 1 n g » 


* D e s c: r i b 0 y o u r s y s 10 m ' s h a r ci w a r 0 c o n f i g u r a t i o n .. 


* 


i ::: ‘ r o v i d 0 s u f f x c:: i 0 n t i n -f o r m a t x o n 

p r o g r a m w a s r u n n x n g a t t. h e t i m e 

s h c:* u. 1 ci a 1 s o p r o v i c:i 0 a d i s w i 1 h 


t o r 0 p r o cJ u c: 0 t h 0 0 r r cj r .. 
t h 0 0 r r cj r o c: c u r r 0 d . I f 
a copy of the program,. 


I n d i c: a 1 0 w h i c rx 
p o s s i b 1 0 .j y o u 


Er rorsi; 


s a s q n 0 x t b o t c h 

: f x n a 1 w r ; 1 0 x t s i 2 0 0 r r o r ■ 

s r 0 1 a t i v 0 a d c J r 0 0 s o v 0 r f 1 o w a t 1 x 1 n s n 


^ s 0 0 k 0 r r o r o n f i 1 0 f :i. 1 0 n a m 0 


s h o r t a d d r 0 s s o v e r f 1 c:x w i n f x 1 e n a rn 0 


u n a h 1 0 t o r 0 o 0 n f i 1 0 n a rr? 0 






1 O t 
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D. 3. 


A R & B R R (J R M E B S H 8 E. ‘i:: 1 


The GEM DOB Ar chive uti1it y, 
m © s s a g e s s d x a g n o s t i c a n d 1 o q i c. 
a t t h e «::: o n s o J. e a s t h e y o c: c: u r « 


AR6£$, r el ur n s t wo 
B o t h t y p e s o f t a t a 3. 


t y p e s o l f a 1 a 3. 

e r r o r m e s s a q e s 


er r or 


show 


D „ 3.. x . F a t a 1 D i a g n o s t i c E r r a r H e s s a g e s 

T a b 1 e D.4 1 i s t s A R 6 8 1 ax t a 1 e r r o r m e s s a q e s i n a 1 p h a b e t i c a 1 o r cl e r w i t h 

0 x p 1 a n a t i o n s a n d s u g g e s t e ci u s e r r e s p o n s e s» 


Tab! e D~~4„ AR68 Fatal Di agnosti c: Error Messages 
M e s s a g e M e a n i n g 


t x I e n a m e n o t i n ax r c h i v e f i 1 e 

T h e q b j e c t m o ci u I e i n cl i c a t e ci b y t h e v a r i a b I e f i 3. e n a m e i s n a t 
x n t h e I i b r a r y« C h e e k t h e t x 1 e n a m e b e f a r e y o u r e e n t e r t h e 
command 1x ne. 

c a n n o t c r e a t e t i 1 e n a m e 

I h e p:« a t h n a rn e f o r t h e f i 1 e x n ci x c a t e cl b y t h e v a r x a b 1 e 
•f i I ename i s i nva3. i d , or the di sk to whi ch AR68 x s wr i t i ng 
x s f li 11 « C h e c: k t h e p a t h n a m e» I f i t i s v a 1 i c:l, t h ex ci 1 s k i s 
f u 11 „ E r a s e u n n e c e s s a r y f i. 1 e s«, i t a n y , o r i n s e r t a n e w 
d :i. s k b e 1 o r e y o u r e © n t e r t h e c; o m m a n cl 1 i n e . 

c: a n n o t o f.::« © n f x 1 e n a m e 

T" h e t i 1 e x n ci x c: a t e d b y t h e v a r i a b 1 ca t x I e n a rn e c: a n n o t b e 
opened because the -filename or the path name is incorrect,, 
C h e c:: k t h e po a t h n a m e a n d t h e til e n a m e b e t o r e? y o u r e e n t e r t h e 
command 1ine. 

x n v a 1 x cl o p t x o n 11 a g s x 

T h e s y m b o 1 , I e 11 e r H o r n u m b e r x n t h e c: o m rn a n d 1 i n e i n d x c a t e d 
h y t h e v a r i a b 1 e >i i s a n i n v a 3. i ci o p 11 o n« R e t e r 8 e c t i o n 3 o t 
this manual tor an explanation of the ARBS command line 
o p 1 1 o n s« S p e c i t y a v a 1 i d cd p t i o n a n ci r e ex n t e r t h e c a rn m a n d 
1 i n e „ 

n a t ar c h i v e f or m a t s f i 1 en ame 
T h e f x 1 e i n d i c: a t ci 
1 i b r a r y „ E n s u r e 

b e f o r 0 y o u r e e n t r 

n o t o b j e e t f i l e s f i 1 © n a m e 

T h e f x 1 e i n ci i c: a t e ci b y 11*”i v a r x a b 1 e f x 1 e n a m e x n a t a n 

o b j e c t f i 1 e a n d c: a n n o t b e a d d e cl t o t h e 1 i b r a r y „ A n y fix e 
a d d e cl t o t h © 1 x b* r a r y rn u s t b e a n o b j e c: t f i 1 e , o u t p u. t b y t h e 
assemb1er 9 AB6B, or the compi1er« Assemb1e or compi1e the 
f x 1 e? b ex t o r e y o u r e e n t e r t h ex A R 6 & c o rn m a n ci I i n ex» 


b y t h ex v a r i a b 1 ex f i 1 ex n a rn e i s n o t a 
t h a t y o u a r e u s i n g 11" ! e c o r r e c: t -f i 1 e n a rn e 

t h ex c o m rn a n ci 1 x n „ 
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T a b 1 e D - 4(c o n t i n u e? d) 


Message 


Meaning 


one and 


o n 1 y o n e o t D R T W X f 1 a g s r e q u i r e d 

T h e A R 6 8 c o m m a n d 1 i n e r e q la i r e s o n e a f t h e D , R , T „ W , o r X 

c o m rn a n d s b u t n o t rn o r e t h a n o n e« R e e n t e r t h e c o m m a n d 1 i n e 

w i t h t h e c o r r e c t c o rn m a n d . R e f e r t o 8 e c t i a n 7 f o r a n 

0 x p 1 a n a t i o n o t t h e A R 6 8 c o rn rn a n d s» 


fi1©name 


not in 1ibrary 

T h e o b j e c t rn o d u 1 e i n d i c: a t e d b y t h e v a r i a b I e f i 1 e n a rn e i s n o t 

i n t h e 1 i I::) r ar y» E.n su r e t hi a t y ou ar © r e q la e s t i n g t h e 

•f i 1 © n a rn e o t a n e x i s t i n g o b j e c t rn o d u i e b e f o r e y o u r e e n t e r 

t h e c o m rn a n d 1:?. n e. 


R e a d e r r o r o n f i I e n a m e 

i" h e f i 1 e i n d i c a t e d b y t h e v a r i a b 1 e f i 1 e r “i a m e c a n n o t b e r e a d« 
T h i s m e s s a g e m e a n s o n e o f t h r e e t h i n g s s t h e t i 1 e 1 i s> t e d a t 
f i 1 e n a rn e i s e o r r u p t e d ;; a h ard w a r e e r r o r h a s o c c: la r r e d;; o r 
w h e n 11"! e f i 1 e w a s c r e a t e d , i t w a s n o t c o r r e c 11 y w r i. 11 e n b y 
A R h:« 8 d u e t o a n e r r o r i n t h e i n t e r n a i i o g i c o f A F< 6 *3 „ 

C o 1 d s t a r t t h e s y s t e rn a n d r e t r y t h e o p e r a t i o n „ I f y o u 

r © c © i v e t h i s © r r o r m e s s a g e a g a i n 9 y o u m u s t e r a s e a n d 
recreate the f :i 1 ©« Use your bac k up f i I e g it you rnai n t ai ned 
o n e« I f t h © © r r o r r e o c: c la r s ^ c f"i © c: k f : o r a h a r d w a r e? e r r o r I f 
11 "i e e r r o r p e r s i s t s, c o n t a c: t t h e t h & v e n d o r o f y o la r s y s t © rn 
t c::« r a s s i s t a ri c e« Y o la s h o u 1 c:i d o t h © f o 1 I o w i n g s 

* Indicate which version of the operating system yoLA are 

usi ng« 

* D e s c r i b e y o u r s y s t © rn s h a r d w a r c: o n f i g li r a t i o n » 

* P r o v i d e s la f f i c i e n t i n f o r rn a t i a n t o r e p r o d la c e t hi e e r r o r » 

I n d i c a t e w h i c h p r o g r a rn w a s r la r'i n i n g a t t h © t i m © t h e 
© r r o r o c c u r r e *:::!« I f p o s s i b 1 ? y o u s h o la 1 d a 1 s o p r o v i. d e a 

d i ss k w i t h ax c o p y o f t h e p r o g r a m « 
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T a b 1 e D ~ 4 « (c o n t i n u e d ) 


M 0 s s a g e M 0 a n i n q 


temp tile write error 

Th 0 d i s k t o wh 1 c h AR 6 8 was w r i t i n g t h e t ernp 0 r a r y t i 1 e 1 s 
f u 1 1 Era s 0 un necess a r y f lies«« i t a n y . 7 or i ns0r t a n 0w 

d i s k b 0t o r 0 y o u r e 0 n t e r t h 0 c o rn rn a n d i i n 0 „ 

usage s AR 68 DRTWX t AV 11 C F D s 2 IIOPMOD 2 ARCH IVE OBMOD 1 
C 0 BM 0 D 2 . . « 111 ! >t i 1 ©spec 2 

T h i s m 0 s s a q 0 1 n d i c: a 1 0 s a s y n t a x 0 r r o r i n t h 0 c: a rn rn a n d i i n 0 
T h e c o r r 0 c t f 0 r m a t t o r t h 0 c o m m a n d i i n 0 i s g i v 0 n ,, w i t h t h 0 
p co s s i b 1 0 0 p t i 0 n s i n b r a c k 0 i sR 0t0 r 1 0 8 0 c t i 0 n 7 1 0 r a 

m o r 0 d e t a i 1 0 d e x p 1 a n a t i. o n o t t h e c o m m a n d I i n 0 ,, 


W r i 1 0 0 r r o r 0 n t i 1 0 n a rn e 

I h e d 1 s k 1 0 w hi c h A R 6 8 i s w r 1 1 i n q t h 0 t i 1 0 1 n d i c a 1 0 d b y t h 0 

v a r i a b ]. 0 t i i 0 n a m 0 i s f u i I « E r a s 0 u n n 0 c: 0 s s a r y t 1 1 0 s i. f 

a n y , o r 1 n s 0 r t a n 0 w d i s k b 0 f 0 r 0 y 0 u r 0 0 n 1 0 r t h e* c: o rn m a n d 
1 i n 0 „ 


D „ 3 « 2 A R 6 8 I n 1 0 r n a i L 0 g i c: E r r 0 r M 0 s s a g 0 s 

7 h e f 0 11 0 w i n g a r 0 m 0 s s a g 0 s t h a t i n d i c a 1 0 t a t a 1 0 r r 0 r s i n t h 0 1 n t e r n a 1 1 0 g i c 
of AH 6 8 si 


c a n n 0 1 r 0 0 p 0 n t i 1 0 n a rn e 


seek 

err cor 

on 

1 ibrary 

Seek 

err or 

con 

tempname 


U n a b I 0 1 0 r 0 c r 0 a 1 0 -1 i b r a r y i s i n f i i 0 n a rn 0 

It you receive any ot these messages except the last, contact your vendor 

t o r a s s i s t a n c 0» Y 0 u s h o u 1 d d o t h 0 1 0 11 o w 1 n g s 

* 1 n d i c a 1 0 w h i c h v 0 r i*a i 0 n 0 t t h e o p e rat i n g s y s t e m y o u a r 0 u s i n g » 

* D e s c: r i i:) 0 y 0 u r s y ch. 1 0 m “ s h a r «.1 w a r 0 e 0 n t i g u r a t i. o n u 

* F' r 0 v 1 d 0 s u 11 i c i 0 n t i n f 0 r rn a t i 0 n 1 0 r 0 p r 0 d u c e t h 0 0 r r o r« 1 n d i c a 1 0 n h i c h 

p r 0 g r a m w a s r u n n i n g a t t h 0 t i rn 0 t h e 0 r r 0 r o c c u r r 0 d « 1 1 p 0 is s i b 1 0 , y 0 u. 

s hi 0 u l d a 1 s 0 p r 0 v i d 0 a d i s k w 1 1 h a c: 0 p y 0 f t h 0 p r co g r a rn „ 

F 0 r t h 0 I a s t 0 r r 0 r , U n a b i e t o r 0 c r 0 a 1 0 -. 1 i b r a r y i s i n t i 1 0 n a rn e ,, y o u s h 0 u I d 

r 0 n a m t h 0 1 0 rn {::> c:« r a r y t i 1 0 i n d i c: a 1 0 d h y t h & v a r i a b 1 e *f ; i 1 0 n a rn 0« A i ;: < 6 & u s 0 d 

t h 0 1 i r a r y 1 0 c r 0 a t e t h e 1 0 n s p 0 r a r y f i 1 e , t h 0 n d e? 1 0 1 e d t hi 0 1 i h r a r y i n 0 r d 0 r 

t co r 0 p I a c: 0 i t w i t i"i t h 0 li p d a t e^ c:i 1 0rnp 0r ar y t i 1 e „ T h i s er r 0r oc: c u r r 0d b &c a us 0 

A R 6 8 c a n n o t w r i 1 0 t i"i 0 1 0 m p 0 r a r y t i 1 0 b a c k 1 0 t h 0 0 r i g i n a 1 1 o c: a t i o n „ T h e 

0 n t i r 0 I i b r a r y i s i n t h 0 t e rn p o r a r y t i 1 0 „ 
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D.4. DUMP ERROR MESSAGES 


DUMP’ returns 
lists the DUMP 
s u g g e s t e d u s 0 r 


t a t a i ,, d i a g n o s t i c e r r o r it* e s s a g 0 s a t t h e c o n s o I e« T a b 1 0 D •- 5 
0 r r cj r m 0 s s a g 0 s i n a X p h a b e t i e a X o r d 0 r w i t h 0 x p 1 a n a t i o n s a. n d 
responses. 


Tab X 0 D-~5« DUMP Er r or Messag 0 s 


M 0 s s a g 0 M 0 a n 1 n g 


U n a h X 0 t o o p 0 n f i X 0 n a rn 0 

E i t h 0 r t hi 0 p a t h n a m 0 f o r t h 0 i n p u t f1 X 0 

v a r i a b 1 0 f i 1 0 n a m 0 i s i n c: a r r 0 c t, 0 r 

rn i s s p 0 X 1 0 d„ C h 0 c k t h e f 1 X 0 n a rn e a n d p a t h 

r 0 0 n 1 0 r t h 0 D U M P c o rn rn a n d 1 i n 0 „ 


i n d i c a t e d b y t h 0 

t hi 0 file n a m 0 i. s 

n a m 0 1:3 0 1 o r £3 y o u 


U s a g 0 s d u m p i" ••••• £> h h h h h h II f i X 0 

T h 0 c o m m a n d X i n 0 s y n t a x i s :i. r "i c o r r 0 c: t« I hi 0 c o r r 0 c t s y n t a x :i. s 
g i v 0 n i n t h 0 0 r r C3 r m 0 s s a g 0 » S p 0 c i f y t h 0 D U M P c o m m a n d a n d 

11* 10 f i X 0 n a rn e „ I f y c:> u w a n t. t o d i s p X a y t h 0 c o n 1 0 n t s o t t h i 0 

file f r om a specific address in t h 0 fiX 0 , sp ecif y th 0 -S 

o p t i o n 1 : o X X o w 0 d h y t h 0 a d cl r 0 s s * R 0 f 0 r t □ S 0 c: t i o n Q „ 2 f o r 
d1scussion of the DUMP command Xine and options« 






G 0 m D o s D o c:: u m 0 n t a t i o n 
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D* 5 . SIZE 68 ERROR MESSAGES 

SI Z E 6 3 r 0 1 u r n s f a t a 1 , t d i a g n o 0 t i c 0 r r o r m 0 s 0 a g 0 0 a t t h 0 c: o n s 0 1 0» T a b i 0 D - 6 
1 i s t s t h e SI Z E 6 8 0 r r o r m 0 s s a g 0 s i n a 1 p h a b e t i c a 1 o r d 0 r w i t h 0 x p 1 a n a t i a n s a n cl 
s u q g 0 s 1 0 cl u s e r r 0 0 q o n e 0 0« 


T a b I e D— 6 » 81 Z E. 6 8 E r r 0 r li 0 s 0 a g 0 0 


l' 1 0 s s a g 0 li 0 a n :i. n q 


F i 1 0 t 0 r rn a t e r r 0 r s t 1 1 0 n a rri e 

f h 0 f i 1 0 i n d 1 c a 1 0 d b y t h 0 v a r i a b I e f i 1 0 n a rn 0 i s n 0 :i t h 0 r a n 

a b j e c t f i 1 0 n 0 r a c a rn m a n d f :i. 1 0» SI Z E 6 8 r 0 cj u i r e s e i t h e r a n 
(.:) t::t j e? c: t -f i 1 0 0 u t p u t b y t h 0 a s s & m h I r 0 r t 0 c:: o m p i 1 0 r , c:j r a 

c: o m a n d -f i. I 0 , o u t p u t b y t h 0 1 i n I-:: 0 r » E n s u r 0 t l “i a t t h 0 + i 1 0 
s p 0 c i f i 0 d i s o n 0 o f t h 0 s e^ a n cl r 0 0 n t e r t h 0 S l Z E 6 8 c 0 rn rn a n d 

1 i n e* „ 


r G-? a cl 0 r r 0 r 0 n 11 i eo? n rn 0 

T h & t i 1 0 i n d i. c a 1 0 cl b y t h 0 v a r i a b i 0 t i 1 0 n a rn 0 i s t r u n c a t e ci, 
Rebui 1 cl the f :L 1 e. Reassembl 0 or recomp i 1 0 , then rel .i nk the 
s o u r c:: 0 f i l 0 b c? f' o r 0 y 0 u r 0 0 n ter t h 0 8 1 Z E 6 8 c o m rn a n ci 1 i n e „ 

u n a b 1 0 t o c:« p 0 n f i I 0 n a m 0 

E i t h E: r t h 0 p a t h n a m e^ i s i n c:. o r r 0 c: t, c:« r t h e? f i 1 0 i n cl i c: a 1 0 d b y 

t h 0 v a r 1 a b 1 0 f i 1 0 n a rn 0 d o 0 s n o t 0 x i s t« C h 0 c: k t h 0 p a t h n a m e 

a n d f i i 0 n a rn e? « R 0 0 n 1 0 r t h 0 SI Z E 6 8 c: o m m a n cl 1 i n 0 „ 








G 0 m D o s D o c u m e rx t a 1 1 o n 
S 0 r i a 1 N u m b e r 006736 


D. 6 . SENDC 68 ERROR MESSAGES 

S E N D C 6 EJ r e t u r n s t w o t y p e s c::* t f a t a 1 e r r o r m e s s a g e s n d i a g n o s tic a n d i n t e r n a I 

1 o g i e e r r o r m e s s a g e s« 

D.. 6 « 1 « D i a g n o s t i c: E r r o r li e s s a g e s 

7 a b 1 e D. 7 I i s t s t h e S E N D C 6 8 d i a g n o s t i c e r r o r m e s s a g e s i n a I p h a b e t i c a 1 o r d e r 

w i t h ex p 1 an at i on s an d sug g 0st ed u.ser resp on s0s * 


T a b i 0 D 7 « S E N D C 6 8 D i a g n o s t i e Ei r r a r M 0 s s a g e s 


M 0 s s a g 0 M 0 a n i n g 


f i 1 0 


f o r m a t e r r o r 8 i : i J. 0 n a rn 0 

T I" ! 0 f 1 1 e i n d i c: a 1 0 d h y t h 0 v a r i a h 1 0 f i I 0 n a rn 0 i s n 0 1 a 

c o n *5 m a n d t i 1 e» T h 0 f i 1 0 i n p u t t o 8 E N D C 6 8 m u s t b 0 a c o m m a n d 
•f i i 0 ,, 0 u t p u t b y t hi 0 1 i n k 0 r (L 06 3 ) „ E n s u. r 0 t h a t t h e *f i 1 0 
s p 0 c i f i 0 d i s ax c o m rn a n d *f 11 0. 


r 0 a d 0 r r 0 r 0 n t i i 0 8 t i I 0 n a rn 0 

r hi 0 t i 1 0 i n d 1 c ax 1 0 d b y t h e v a r i a b i 0 1 : i 1 0 n a m e i s t r u n c: ax t 0 d ,, 
R 0 h li i 1 d t h 0 f i 1 e h y r e c o m p 1 1 i n g 0 r r 0 a s s 0 m b 1 i n g M a n d r 0 1 i. n k 
it b0tor0 you r000 1 er th0 SENDC 68 c ommand iin0„ 


u n a b 1 0 1 0 c r 0 a 1 0 f i 1 0 n a m 0 

T h i s m 0 s s a g e i n d i c a 1 0 s a n i n v all d p a t h n a rn e? f 0 r t h 0 0 u t u t 

f :i. 1 0 i r"! ci i c a 1 0 d b y t h 0 v a r i a b 1 0 *f i l 0 n a m 0» 11 c: a n a 1 s o m 0 a n 

t h a t 11 " ! 0 d 1 s k 1 0 w h i c: h 8 E N D C 6 8 1 s w r i t i n q i s f u 1 1 « C h 0 c.:: k 

t h 0 p a t h n a rn 0 „ I f i t 1 s c o r r e c t, t hx 0 d i s k i s f u 11 « E r a s e 

u n n 0 c e s s a r y t i 'I. 0 s, i f a n y „ 0 r i n mi. 0 r t a n 0 w d i s k b 0 1 0 r 0 y 0 u 

r 0 0 n 1 0 r t h 0 S E N D (Z 6 8 c o rn m a n ci 1 :i. n 0. 


u. n a b 1 0 1 0 0 p 0 n f i 1 0 n a m 0 

T h 0 i n jo u t f i 1 0 1 n d i c a 1 0 d b y t h 0 v a r i a b 1 0 f i 1 0 n a rn 0 ci 0 0 s n 0 1 
0 x i s t» C h 0 c k t h 0 t :i 1 0 n a m 0 a n d r 0 1 y p 0 t hx 0 S E N D 6 8 c co rn m a n d 
11 rx 0 „ 

U s a c^ 0 s s 0 n d c 6 8 L 11 c. 0 rn rn a rx cl f :i. 1 0 L o 1.1 1 p u t f :i. 1 0II 

This message indicates a syntax error in the SENDC 68 
c 0 rn m a n d 1 i rx e« T h 0 c 0 r r 0 c: t s y rx t a x i s g i v e n i rx t h 0 0 r r 0 r 

m 0 s s a g 0« R 0 1 y p 0 t h e c 0 m m a rx cd 1 i n 0 u s i n g t h 0 c o r r e c t s y n t a x » 









U e m D o s D o c u m 0 n t a t i o n 
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D „ 6 « 2 N 8 El N D C 6 8 I n t e r n a 1 L 0 g i c E r r o r li 0 s s a g 0 s 

T I"! 0 f o 11 o w i n g i 0 a m 0 s 0 a g 0 t h a t i n d i c a 1 0 s a f a 1 a 1 0 r r o r 

1 o g i c o f S E N D C 6 8 5 

0 0 0 k 0 r r o r o n t i 1 0 f i 1 0 n a rn 0 

If you receive this message, contact your vendor* 
tollowing? 

* I n d i c a t e w h i c h v e r s i o n o f t h 0 o p 0 r a t i n g s y s 1 0 m y o u. a r 0 

* D e s c r i b 0 y o u. r s y s t e m s h a r d w a r 0 c o n f i g u r a t i o n » 

* P r o v i d 0 s u f t i c i n t i n f o r m a t i o n t o r 0 p r o d u c t h 0 0 r r o r 

{::«r c« q r a rn w a s r u n n :i. n g a t t h 0 t :i m e t h 0 0 r r o r o c c u. r r” 0 cl „ 

s h o u 1 d a I s o p r o v :i. d 0 a d i s k w i t h a c o p y o *f t !'"i p r o g r a m» 


in the internal 


y c:« u h o u 1 d d o t h b 


li si ng» 


I n d i c a t e w h i c h 
I f p o s s i b 1 0 , y o li 



6 e m D o s D o c u m e n t a 1 1 o n 
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D„7 * 81D&8 ERROR MESSAGES 

The GEM DOS debugger, SID68, returns two types of error messagess non fataI 
d i a g n o s t i c e r r o r m os s s a g e s, a n d m e s s a g e s i n d i c a t i n q f a t a 1 e r r o r s i n t h os 
i n t e r n a 1 ]. o g i c: o t SID 6 8» 

D a 7„ 1.« D i a g n o s t i c: E r r o r M e s s a g e s 

D i a g n o s t i c: e r r o r rn e s s a g e s a r e r e t u r n e d a t t h e c: o rn s o 1 e a s t h e e r r o r s o c c u r « 

T a b 1 e D - 8 1 i s t s t h e SID 6 8 e r r o r m e s s a q e s i n a 1 p h a b e 1 1 c a 1 o r d os r w i t h 

e x p 1 a n a t i o rn s a rn d s u g q e s t e c:l u s e r r e s p o n s e s „ 


T a b 1 e D ••••* 8« 81D 6 9 D i a g n o s t i c E r r o r li e s s a g os 


M e s s a g e M os a n i n g 

B ai c:i o r n o rn - e x i s t e n t R A M a t H E X rn o « 

This error occurs in response to e\ Set (S) , Set Word (SM) „ 
or Set Longwo r d < SL) command« 7 he m e ssage i nd i c at es one of 
two thirngss 

* T h e m e rn o r y I o c a t i o rn a t H E X n o,, i s R e a d 0 n I y , a n I / 0 
p o r t «, o r n o n - e x i s t e n t « U s e a n o t h oh* r 1 o c a t i. o n » 


* T h e rn e rn o r y 1 o c a t i o rn i s d a rn a g e d« C h e c k t h e h a r'd w ex r e« 

B a d r e 1 o c a t i o n b i t s 

I h 1 s rn e s s a g e i s r e t u r rn e d f r o m t hi e B D 0 S P r o g r ex rn L o a d 

F u rn c t i o n (5 9) , a rn d m e a n s o n e o f t w o t h i n g s s 

* Th e c: omman d f i 1 e hi as fa eern c or r up t ed «. Reb u i i d t h e f i 1 e« 
R e a s s oh* m b 1 oh o r r oh c o rn p i 1 e t h e s o u r c e f i 1 e , t h e n r e 1 i n k 
t h e* f i I e b e t o r e y o u r e e n t ex r t h e S 11) 6 8 c o m m a n d 1 i rn e .. 

* T h oh t i 1 e i s 1.1. n k e cJ t o a n ex b s o 1 u t e i o c a t :t a n i n m oh m o r y 

t h a t i s ex 1 r e ex d y o c c u p:* i e d b y SID 6 8 „ L i rn k t h e f i 1 e t o 

a n o t hi e r 1 o c a t i o n „ 

SID 6 8 o c: c: u p i e s a p p r o x i rn a t e 1 y 2 0 K a f rn e rn o r y , ex rn d r e i d e 

a t 11 " ! e h i g h oh s t a d d r oh s s e s w i t h i n t I n e T P A« T h e 

r oh c: o rn rn oh rn d e c;t 1 o c: a t i o rn f o r i i n k i rn g y o u r* f i 1 i s> t h e b ex s e 

a d d r e s s o f t h oh T P A •+* i 0 0 H« B D 0 S F u n c t i o n 6 3 « G e t. / 8 e t 
T P A L i m i t s, r e t u r n s t h e h i g h a rn d 1 o w h o u n d ex r i e s o f t hi e 
TP A. 




6 e rn D o s D o c u m e n t a t i o n 
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Tab I e D-8■ (c: on t i n tied ) 

M e s s a g e M e a n i n g 


C a n n o t c: r e a t e f i i e 

T h i s 0 r r o r o c c u. r s d u r i n g a W r i t e (W) c o rn rn a n d „ T h e d i s k t o 

w h i c: h SID 6 8 i s w r i t i n g h a s n o m o r e d i r a c t o r y s p a c os 

avai 1 ahlej i n ef fect, the di sk i s f u 11 « If you have 

another drive available, r os enter the W command and direct 

t h e f i 1 e t o the d i s k o n t h a t cl r i v e« I f y o u d o n o t h a v e 

another drive available, you must exit SID68 (and lose the 

c o n t e n t s o f m e m o r y) « E r a s os u n n e c e s s a r v f i 1 e s, i f a n y ,, o r 

i n s e r t a n e w d i. s k .. 

(7 a n n o t o p e n f i 1 e 

T h i s e r r o r o c c u r s d u r i n g a R c o m m a n cl« 11 i n cl i c a t e s a n 

i n c o r r e c t p a t h n a m e o r f i 1 os n a m eC h e c k t h os p a t h n a rn e a n d 

f i 1 e n a m e b e f o r e y o u r e e n t e r t h e c: o rn rn a n d 1 i n e, 

C a n n o t o p e i n p r o g r a m t i 1 os 

T h i s rn e s s a g e o c: c: u r s i n r os s. p o n s e t o a n E c o rn rn a n d - 1t 

i n d i c: a t os s a n i n c o r r e c t p a t h n a m e o r f i 1 os n a m e« C h os c k t h os 
p a t h n a rn e a n d f i 1 e n a rn os b e f o r e y o u r e e n t os r t h e c o m rn a n d 1 i n e „ 

E R R 0 R , n o p r a g r a m o r f i 1 e 1 o a d e d 

T h i b e r r o r rn e s s a g e o e c u. r s i n r e s p o n s e t cd a V c am m a n d w h e n 

y o u s p €5 c i f y t h e c o m m a n d h u t n o f i 1 e i s 1 o a d e d * L o a cl a f i 1 e 
b e f o r e y o u r e os n t e r t h e V c o rn m a n d» T h e f i 1 e c a n b e 1 o a cl e d 
w i t h a n E o r R c: o m rn a n d , o r b y s p e c i f y i n g t h e f i 1 e n a rn e w h os n 
y o u. i n v o k e SID 6 8. 

F .i 1 e t o o b i g -. r e a d t r u n c a t os d 

T h i s m e s b a g e o c c u r s d u r i n g a R c o m rn a n d w h os n t h e f i 1 e b e i n g 
r os a d i b t o o 1 a r g e t os f i t i ri rn e m o r y„ 81D 6 8 r os a d s o n 1 y t h e 

p o r t i o n o f t h e f i 1 e t h a t c a n b os r e a d i n t o t h e e x i s 1 1 n g 
rn e m o r y „ T o d e b u g t h i s p r o g r a m , a d d i. t i o n a 1 m os m os r y h o a r d b 
m u b t b e add e cl t o t h e s y s t os m c o n f i g u r a t i o n .. 

F i 1 os w r i t e e r r o r 

T h e d i b k t o w h i or: h SID 6 & i s w r i t i n g i b f u 11 os r t hi e cl i s k 
c o n t a i n s a b a d s e c t o r * R os t r y t h e c o rn rn a n d * 1 f t h e e r r o r 

p e r b i b t b , a n d y o u h a v e a n o t h e r cl i s k d r i v e a v a i 1 a h 1 e, 
r os cl i r os c t t h e o u t p u t t o t h e ci i b k a n t Is a t d r i v os. 11 y o u ci o 

n o t h a v e a n o t h e r d r i v e a v a i 1 a b 1 e, y o u m u s t e x i 1 81D 6 8» U b e 
t h os 8 T A 1 c os rn m a n d t o c h os c k t h e s p a c: os o n t h e d i s k « 1 1 i t i s 

•f u. 11 , os r a s e u n n os c e b b a r y t i 1 e s , i f a n y ,, o r i n s e r t a n e w 
d i s k „ B e c a u b e t h e c o n t e n t b o t m e m os r y a r e 1 os s t w h os n y os u 
exit SID68, you must reload the file in memory. If the 
ci i s k w a s n os t f u. 11 , i t h a s a b a d s e c t os r „ V o u s Is o u 1 ci r e p 1 a c os 
t h e ci i b k « 




6 0 m D o s D o c: u m e n t a t i o n 
8 e r i a 1 N u. m b e r 0 0 6 7 3 8 


Tab 1 e D-8 . <c on t inued) 


H e s s a g e M e a n i n g 


* * i 11 0 g a 1 s i z 0 f i e i d 

T h i s 0 r r o r o c: c u r s d u r i n g a n L c: o rn rn a n d« T h e e i z e f i e 1 d o f 
t h 0 i n s t r u c t i o n b e i n g d i s a s s e m b 1 e d h a s a n i 11 e g a 1 v a I u e« 

U s 0 a D c: o rn rn a n d t o d i s p 1 a y t h e i o c a t i o n o f t h e e r r o r « T h i s 

e r r o r c o u 1 d b e c a u s e d b y o n e o f t h r e e t hi i n g s s 

* T h 0 m 0 rn o r y 1 o c a t i o n b e i n q d i s a s s e m b 1 e d d o e s n o t c o n t a i n 

a n i n s t r u c t i o n . E n s u r e t h a t t h e a r e a s e 1 e c 1 0 d i s a n 

1 n s t r u c: t i o n .. II! f n o t, r 0 0 n 1 0 r t hi 0 L c o m m a n c:l w 1 1 hi a 

c: 0 r r e c t 1 o c a fc i 0 n « 

* T h 0 s i z e f i 0 1 d o f t h 0 i n s t r u c t i 0 n h a s b 0 0 n c o r r u p 1 0 d « 

U s 0 t hi 0 d 0 b u g g i n q c o rn m a n d s i n SID 6 8 t o 1 0 o k f o r a n 
0 r r 0 r t h a t c : a u s 0 0 t h 0 p r 0 g r a rn 1 0 0 v e r w r i 1 0 1 1 s 0 11 „ 
R 0 f 0 r t o S 0 c t i o n 9 f o r a 00 m p 1 0 1 0 d 0 s c r i p t i 0 n 0 f t hi e 

SID 6 8 c 0 rn m a n d s a n d c:> p t i 0 n s» 

* A n i n v a 1 i d 1 n s t r u c t i. c:« n w a s g 0 n 0 r a 1 0 d b y t h e c o m p i 1 0 r 0 r 

a s s 0 m h 1 0 r u s 0 d 1 0 c r 0 a 1 0 t hi e p r 0 q r a rn» E 0 c 0 rn p i I 0 0 r 

reassemble the source file before you reinvoke 811 ) 68 . 


I n u f f i c:: i 0 n 1 m 0 rn 0 r y 0 r b a cl f :i. i 0 h 0 a d 0 r 

T h 1 s m 0 s s a g e 0 c: c u r* s i n r e s p 0 n s 0 1 0 a n Ei! c o rn rn a n d „ T hi 0 0 r r 0 r 

c: 0 u 1 d b e c: a u s 0 d b y o n 0 0 T ; t h r e? 0 t h i n g s s 

* T hi e s y s 1 0 m y 0 u a r e la s i n g d o 0 s n 0 1 h a v 0 e n 0 u g hi m 0 m 0 r y 

a v a i 1 a b i 0.. E n s u r 0 t hi a t t hi e? p r 0 g r a rn a n d S 11 ) 6 8 f i t i n 1 0 

t hi e T P A» IE k i t 81 D 6 8 « U s e t h 0 8 1 2 E 6 8 u t i 1 i t y t o 
d i s:-. p 1 a y t hi e a m c:> u n t 0 f s p a c: 0 y 0 u r p r 0 g r a rn 0 c: c u p 1 e s i n 
memory 81 D 68 i s approx i mat el y 20 K bytes. The BOOS 
G 0 1 / 9 0 1 T F‘ A L. i rn i t s F u n c t i 0 n < 6 3 > r 0 1 u r n s t h e h i q h a n d 
1 ow boundaries of the TPA« If you d0 not have 
s u f f i c: i 0 n t s p a c 0 1 n t hi 0 T F ; * A 1 0 0 x 0 c u t e y 0 u. r c: 0 rn m a n d 

f i 1 0 a n d E> ID 6 8 s i rn u 11 a n e o u s 1 y ,, a c j d i t i 0 n a 1 m 0 m 0 r y b 0 a r d s 
inut b 0 ad d 0 d 1 0 y 0ur s y s 1 0 rn c: on f i g u.r at i 0 n « 








G 0 m D o s D o c u m 0 n t a t i a n 
Serial Number 006738 


T a b 1 0 D - 8« (c o n t: i n u 0 d ) 


ani ng 


T h e t i I e i s n o t a c: o rn m a n d f i 1 e o r h a s a c o r r u p t e d 
h 0 a d 0 r * 11 t h e c o m rn a n d f i i 0 d o e s n o t r u n , b u t y o u a r 0 

s u r 0 t h a t y o u r m 0 m o r y s p a c 0 i s a d 0 q u a 1 0 , u. 0 0 t hi 0 R 
c d rn m a n d t a 1 o o k a t t h 0 f i 1 0 a n d c h 0 c k t h 0 t o r m a t» V o u. 

rn i g h t b 0 t r y i n g t o d e b u g a f i 1 0 t h a t i s n o t a c:: o rn m a n d 
f i 1 0 . 11 i t. i 0 a c: o m m a n d f :i 1 0 7 t hi 0 h 0 a d 0 r rn i g h t h a v e 

b 0 e n c:: o r r u. p 1 0 d „ F ; : 0 a s s 0 m b 1 0 o r r e c o rn p i 1 0 t h 0 0 o u r c 0 
f i 1 0 b 0 1 o r 0 y o u r 0 0 n 1 0 r t h 0 E c o m m a n d 1 :i. n 0 ■ I f t h 0 
0 r r o r p 0 r s i s t s , i t rn i q h t b 0 c: a u s 0 d b y a n 0 r r o r :i. n t h 0 
i n 1 0 r n a 1 1 o g i c o f 81D 6 8. C o n t a c fc y o u r v 0 n d o r f a r 

a s s i s t a n c 0 « V o u s h o u i d d o t h 0 f o 11 o w i n g s 

I n d i c a 1 0 w h i c h v 0 r s i o n a t t h 0 o p 0 r a t i n g s y s 1 0 m y o u 
are usi ng „ 

D 0 s c: r i b 0 y o u r s y s 1 0 m s h a r c:i w a r 0 c: o n f i g u r a t i o n 

P r o v i d e s u f f i c i 0 n t i n f o r m a t i o n t o r 0 p r o d u c e t h 0 

0 r r □ r ,, I n d 1 c a 1 0 w h i c. h p r o g r a m w a s r u n n i n g a t t h 0 

t i m 0 t h 0 0 r r a r a c c u r r 0 d « I f p o s s i. b 1 0 , y o u h o u 1 c:S 

a 1 s o p r o v i d e? a d i s k w i t h a c 0 p y o f t h 0 p r o g r a m. 

7 h 0 c o rn rn a n d t i 1 0 y o u a r 0 d 0 b u g g i n g i s 1 i n k 0 d t o a n 
abso 1 Lit 0 1 oc at i on i n rnernor y that i s a 1 r eady oc cup i ed by 
81D 6 8« SID 6 8 i s a p p r o x i m a t e 1 y 2 0 K b y 1 0 s n a n d u s u a 11 y 
r 0 s i d 0 s i r"i t h 0 h i g h 0 sh. t a d d r 0 s s 0 s o f t h 0 T P A« T h 0 

r 0 c o rn rn 0 n d 0 d 1 o c a t i o n t o r 1 i. n k .i n g y o u r -f i 1 0 i s t h 0 bas 0 

addr 0 ss o*f th 0 TPA + 100H. Th 0 BD08 Get/Bet TPA Li mi ts 
Function (63) returns the high and low boundaries of 
the TPA„ 






8 e m D o s D o c u m e n t a t i o n 
S 0 ria1 Numb er 006738 


T a b i e D - 8.. (c: o n t i n u e d ) 

li e s s a g e li e a n :t n g 


Read error 

T h i s m e s b a g e i n d i c a t e b o n e o t t h r e e t h i n g b » T r y t h e 
o p e r a t i o n a g a i n« I f t h e e r r o r p e r s i s t s , y o u h a v e o n e o t 
t h e t d 11 o w i n g p r o b 1 e rn s s 

* A w r i t e e r r o r a t t h e t i m e t h e t i 1 e w a s c: r e a t e d .. V o li 

rn u s t r e c r e a t e t h e f i 1 e „ I t t h e e r r o r r e o c c u r b , o r i t 

you c anno 1 wr 1 1 e t o t he d i b k , t h e d i sk :i. s bad. 

* A b a d d i s k « U s e PIP o r C 0 P Y t o c o p y t h e t i 1 e f r o rn t h e 

b a d d i b k t o a n e w d i b k « A n y f i 1 e b t h a t c: a n n o t b e 
copied must be recreated or replaced -from backup -files. 
D i s c a r d t h e d a m a g e d d i s k . 

* A h a r d w a r e e r r o r . 1t t h e e r r o r p e r s i s t s „ c h e c k y o u r 

hardware. 


u n !*•: n o w n o p c o d e 

T h i s e r r o r o c c u r s i n r e b p o n s e t o a L c o m rn a n d 1 t t h e m e m o r y 

1 o c a t i o n b e i n g d i s a s s e m b 1 e d d o e s n o t c o n t a i n a v a 1 i d 

i n b t r u c t :i. o n» 1" h e e r r o r rn i g h t h a v e b e e n c a u. s e d b y o n e o f 

three things: 

* You gave the L command the? wrong address. Reenter the 
L c o rr? m a n d w i t h t h e c o r r e c: t a d ci r e s s - 

* T h e t i 1 e i s n o t a c: o m m a n d f i J. e„ M a k e s u r e t h a t t h e 

•f i 1 e y o u p e c i t y i s a c o m m a n d tile a n d r e e n t e r t h e L.. 

command. 

T h e c: o m rn a n d f i 1 e h a s b b e n c o r r li p t e? d« R e a s s e m h 1 e o r 
r e c o m p i 1 e t h e s o u r c e f i 1 e h e t o r e y o u r ca r e a d i t i n t «o 

m e m o r y w i t h a L o a d f : o r E x e c u t i c:> n (E) o r F< e a d ( R) 

command, as appropriate. It the problem persists, use 
the debugging commands in SID68 to look for an error in 
t h e p r o g r a m t h a t c a u s e s it t o o v e r w r i t e i t s e 1 f « R e f e r 

t o t h e S e c t i o i" i S' f o r a c o m p 1 e t e d e <s c: r :i p t i o n o f t h e 

SID 6 8 c a rn m a n d s a n d o p t i a n s * 







6 e m D o s D o c u m e n t a t i o n 
Seria1 Number 006738 


D» 7 „ 2 n 81D 6 8 I n t. e r n a 1 L o g i. c E r r o r ii e s s a q e s 

The Tallowing are messages indicating fatal errors in the internal logic of 
SI.U68» 

i 1 1 e g a 1 i n s t r u c t i o n f o r m a t # 

L) n k n o w n p r o g r a rn X o a d e r r o r 

I f y o u r e c e i v e o n e o f t h e s e rn e s s a g e s ^ c o n t a c t y o u r v e? n cl o r f o r a s s i s t a n e e„ 

V o u s h o u 1 d d o t h e f o X 1 o w i n g s 

•ft- I n cl i c: a t e w h i c 1“i v e r s :i. o n o f t h e o p e r a t i n g s y s1 e rn y o la a r e u s l n g « 

* D e s c r i b e y o u. r s y s t e m s h a r d w a r e c o n f i g la r a t i o n « 

•ft- P r• o v i d e s la. f f i c: i en t i n f r rn a t i on t o r ep r o cl la c: e t h e e r r or „ I n d i c a t e w h i c h 

p r o g r a rn w a s r u n n i n g a t t h ® t i m e t h e e r r o r o e c u r r ed „ 1 f p o s s i b 1 e 9 y o u. 

s h o u. 1 cl a 1 s o p r o v i c:l e a cl i •-;> k w i t hi a c. o p y o f the p r o g r a m« 


E n d o f A p p ca n d i D 




8 e m D o s D o c u m e n t a t i o n 
5 e r i a I N u m b 0 r 0 O 673 Q 


MOTOROLA S-RECQRD FORMAT 


T h e M o t o r o 1 a 8 -• r 0 c o r d f 0 r m a t i 0 a m e t h 0 d o f r e p r 0 s e n t i n g b i n a r y m e rn o r y 
i rn a g e s i n a n A S C 11 f o r rn . T h e p r i rn a r y la s e o t 8 - r e c o r d s i s t o p r o v 1 d 0 a 
c: o n v 0 n i 0 n t f 0 r m f 0 r t r a n s p o r t i n g p r o g r a m s b e t w 0 0 n c 0 m p la 1 0 r s „ 8 i n c: 0 m c::« s t 

c o m p u 1 0 r s h a v e a rn 0 a n s o f r 0 a d i n g a n d w r i t i n g A S C 11 i n f o r m a t i o n „ t h 0 f o r m a t 
i s w i d 0 1 y a p p I i c a b 1 0 „ T h e 8 E N D C 6 8 u. 1 ill t y p r 0 v i d 0 d w i t h G E.* M D 0 8 c a n b 0 u s s* d 
t o c 0 n v 0 r t p r o g r a m s i n t o 8 r e c 0 r d 1 0 r m« 

An S r ec: or d t i 1 0 consi st s of a soquence of 8 -r ec or ds of var i olio t yp0s« Th0 

0 n t i. r 0 c: cj n 1 0 n t o f a n 8 r 0 c: o r" d i s A S C11W h e n a h 0 k a ci 0 c i m a 1 n u m b 0 r n 0 0 d s t a 
b 0 r © p r 0 s 0 n 10 d i n a n S - r 0 c: 0 r d 9 it i s r e? p r e? s 0 n 10 d b y t h e A 8 C 11 c h a r a c: 10 r 
•f 0 r t h h 0 a d 0 c: i m a 1 d i g i t s t: o m p r i s i n g t h 0 n la rn b 0 r e Ei. a c h 8 —r 0 c 0 r d con t a i n Ei- 
t h t? f i v 0 f i e? 1 d s s h o w n i n F i g u. r 0 E -1« T a b 3. e E — 1 c j 0 s c r i b 0 s £/ a c h f i 0 1 c:l. 


i ::: 1 0 1 d s 

{ 8 ! type ! length i address I data i cksum ! 

SiS0*s 

1 1 2 2, 4 or 6 varies 2 

* 1 n c: h a r a c 1 0 r s 


F i g u.r 0 E-~ :i „ 8-r ec or d F or mat 












VS y- 


GemDos Documentatxon 
S e r i a 1 N u m b e r 0 06738 


T a b 1 e E - i . 9 - r e c o r d F i e 1 d D e s c r i p t i a n • 


F i e 1 d 


Description 


type 


i ength 


T h e A E> C11 c h a r a c t e r 8T h i s s i g n at I s t h e h e q i n n i n g o t t h e 8 - 
record« 

A d i g i t b s? t w e e n 0 a n d 9 , r e p r e s e n t e d i n A 8 C11 , w i t h t h e 

e x c e p t i C3 n s t h a t 4 a n d 6 a r e n o t a 11 o w e d * T h e u. s e o -f e a c h 

t y p e v a I u e i s e x p I a i n e d i n T a b 1 e E—2« 

The numher o f char acter pai r s i n the rscor d «, ex c 1 u.d 3. ng the 

•f i r s t t h r e e f i e 1 d s.. (T h a t i s , o n e h a i f t h e n u rri b b r o f t o t a 1 

c h a r a c t e r s i n t h e a d d r e s s 9 d a t a , a n d c k s u m f i e 1 d ©.. ) T h i s 

•f i © 1 d h a s t w o h e x a d e c: i m a 1 d i g i t s r e p r e s e r 1 1 i n g a o n e ~ b y t e 
quantity« 


a d d r e s b T h e a d d r e s s a t w h i c h t h e d a t a p o r t i o n o t t h e r e c o r • d i s t o 

r es i d e i n memor y« T h e ci at a g oe s t a t h i s ad d r e s s an d 
success! ve 1 y hi gher numbered addresses. The 1 ength of thi s 
f i. e 1. d i s d e t e r m i n e d h y t h e r e c o r d t y p e i n t h e s e c: o n d b y t e 
o f t h e 8 -• r e c o r d « 


data 


A var i ab I e 1 en g t h f i e 1 d c: on t a i n x i"i g t h e ac t ua 1 d at a t o b e 

1 a a d e ci :s. n t o m e rn o r y« S p e c x f y e a c h b y t e o t d a t a a s a p a x r o -f 

hi e x a d e c i m a i d x g i t rs x n A 8 C11 


c ksurn 


A c: h e c k s u m c: o m p u t e o v e r t h e 1 e n g t h ,, a d d r e s s 9 a n d d a t a 
f i e 1 d si- „ C o m p u t e t h c h & c k s u m & s t o 11 o w rs s 


* a d d t h e v a 1 u ca s o t t h e c h a r a e. t e r p a x r s x n t h e 1 e n g t h 9 

a d c:l r e s s>, n ci d a t a t i e^ ]. ci s 

* t a k e t h e o n e s c: o m p 1 e m e? n t o f t h e s u m 

* d r a p t h e m o s t s i g n x t i c a n t fo y t 


E n t b r t h e 1 e a s t s i g n x f i c a n t b v t e v a 1 u e i n t h c? c k s u rn t i e 1 d 

a si- t w C3 A 8 C11 h e? x a d e c i rn a 1 d i g i t s« 


T h e r e a r e e i g h t t y p ce s o f 8 - r e c: o r d s * T h e y c a n b e d i v i d e d x n t o t w o 

c:: a t e g o r x esi- s r e c: cj r d s c: o n t a x n i n g a c t li a 1 d a t a a n d r e c o r ci s u s e ci t. o d e f i n e a n d 

ci e 1 i m 3 . t g r o u p s a f ci a t a ~~ c o n t a i n 3 . n g r e c a r d s . T y p e s 1 „ 2 , a n d 3 a r e r e s e r v b d 

•f c::« r r e c: o r ci s i n t l "i e? t i r s t c: a t e g c::« r*" y $ t y p e s C> 9 5 , 7 , t <3 9 a n ci 9 t o r r e s e r v e d f o r - 

r e c a r d s i r i t h e s b c o n d c a t e g C3 r y „ T y p e s 4 a n d 6 a r e n o t a 11 o w e ci „ T a b 1 e E - 2 

ci e f i ri e ch- t h e t y p e s» 

Motes All byte values in Table E.2 are expressed as two ASCII characters 

r e p r e* s b n t x n g t h e h e x a d e c i m a 1 v a 1 u e« 






S e rn D o s D o c: u m 0 n t a t i o n 
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T a b I 0 E 2S •• R 0 c 0 r ci T y p 0 D 0 t :i. n i t i o n s 
'Type I'leani nq 

0 i h i s t y p e i s a h 0 a d 0 r r 0 c 0 r d u s 0 ci a t t hi e b 0 g i n n i n g 0 t a 

g r o u p o f B - r 0 c: 0 r d s» T h 0 d a t a f i 0 1 ci c a n c o n t a i n a n y d 0 s i r 0 d 
1 d 0 n t i f y x n g i n t c:> r m a t i 0 n« T h e a d d r 0 s s t i 0 I d i 0 t w 0 b y 1 0 s 
1 0 n g a n ci i s n o r m a 11 y z 0 r cx« 

1 T h i s t y p 0 o f r 0 c 0 r d c:: 0 n t a i n s n 0 r rn a 1 d at t a» T h 0 a d d r 0 s s f i 0 J. d 

:i. s t w 0 b y 1 0 s 1 o n g « 

2 T h i s t y p 0 i s t h 0 s a m 0 a s t y p 0 j. 0 x c: 0 p t t h & a d ci r 0 s s 1 1 0 1 ci x s 

3 b y 1 0 s 1 o n g „ 

.3 T h i s t y p e i s t i™j 0 s a m 0 at s t y p 0 J. 0 x c 0 p t t hi 0 a ci ci r 0 s a> t i 0 1 ci i s 

4 bytes long. 

5 T hi i s t y p e i n ci i c: a 1 0 s t i" i 0 n u m b 0 r 0 f t y p 0 i , 2 , a\ n d 3 r e c 0 r cl s 

in a group at S-r©cords. The count, is placreci in the address 
•f i 0 1 ci. T h 0 d a t a f i 0 1 cl i s 0 m p t y „ 

*7 T h x s r e c o r ci s i g n a 1 s t h 0 0 n ci o f a h 1 o c k o f t y p 0 3 S - r 03 ? c o r ci s» 

I f ci 0 s x r 0 d h t h 0 4 ■- b y 1 0 a d ci r 0 s s t x 0 1 ci c a n i::) 0 u. s 0 d t o c 0 n t a x n 
a». n a d d r 0 s s a t w h i c h t o p a s s c o n t r cx 1 T i "i 0 ci a t a t i 0 1 d i s 
empty. 

6 T h i s t y p 0 i s t h i 0 s a rn 0 a s t y p 0 7 0 x c: 0 p t t h a t x t 0 n ci s a b 1 o c: k 

o t t y p 0 2 8 •••“ r 0 c: o r d s a n d t h 0 a d ci r 0 s s t i 0 1 d i. s 3 ta y 1 0 s 1 o n g „ 

9 T h 1 s t y p 0 x s t h 0 s a m 0 a s t y p 0 7 0 x c;: 0 p t t h a t x t 0 n cl s a b I o c: k 

o f t y jp 0 1 8 r 0 c: cx r ci s a n ci t h 0 a d d r 0 s s *f i 0 i ci i. s 2 h y 1 0 s 1 o n g » 


E n ci cx t A p p 0 n ci i x E 






